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PREFACE 


This manual is intended for the person who is charged with 
configuring the GCOS 6 MOD 400 system software to meet the char¬ 
acteristics and requirements of his installation site. This 
person is assumed to be well acquainted with the GCOS 6 MOD 400 
Executive and with Honeywell's Series 60 (Level 6) minicomputer 
systems. In addition, this person is assumed to have read the 
System Concepts manual, and if he intends to build a system sup¬ 
porting communications devices, the Communications Processing 
manual. The Manual Directory at the beginning of this manual 
lists the titles and order numbers of pertinent documents. 

This publication describes in detail the procedures necessary 
to build the system, the system building directives from which 
the MOD 400 Executive is assembled, and the utility programs used 
in the building process. 

Section 1 of this manual introduces the subject of system 
building and briefly describes the contents of the document. 

Section 2 outlines information the system builder must gather 
prior to configuring a system to his specifications. 

Section 3 describes the three stages of system startup and 
the purpose of each stage. Section 3 also describes the opera¬ 
tor's and the system's actions during system startup. 

Section 4 describes how to use the interactive CLM directive 
generation program, M4_SYSDEF. 


The information and specifications in this document are subject 
to change without notice. This document contains information 
about Honeywell products or services that may not be available 
outside the United States. Consult your Honeywell Marketing 
Representative. 
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Section 5 describes in detail the noncommunications direc¬ 
tives that are processed by the Configuration Load Manager -- a 
system software tool — as it configures the system to stipulated 
specifications. 

Section 6 describes communications-related directives pro¬ 
cessed by the Configuration Load Manager. 

Section 7 lists the contents of the system disks on which 
GCOS 6 MOD 400 and other related software components are 
available. 

Section 8 includes a number of miscellaneous but important 
technical notes, most of which pertain only to certain installa¬ 
tion sites. This section should be read before attempting to use 
the system. 

Appendix A presents an overview of the various types of halts 
possible during system startup. 

Appendix B lists the names and approximate sizes of all sys¬ 
tem overlays, which may be used as overlays or, where optimum 
speed is desired for the related function, selectively made per¬ 
manently resident in memory. 

Appendix C contains minimum system guidelines and a list of 
supported equipment. 

Appendix D describes configuration considerations relative to 
the Power Resumption facility. 

Appendix E deals with configuration information (including 
linking) pertaining to the Data Entry Facility. 

Appendix F describes configuration information for the Remote 
Batch Facility. 

Appendix G presents configuration information relative to the 
file transmission capability. 

Appendix H and Appendix J provide configuration information 
pertaining to IBM Workstation Facilities. 

Appendix K presents configuration information for the 
Programmable Facility/3271. 

Appendix L describes installation and activation of the 
Listener and Login capability. 

Appendix M provides a handy checklist for use with the 
M4 SYSDEF interactive CLM directive generation program. 
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Appendix N provides configuration information for the 
logging capability. 

Appendix P provides configuration information for the Display 
Formatting and Control software. 

After reading this manual, the user should be able to build 
the system for initial operation and onsite personnel training, 
and rebuild the system later on, if necessary, to satisfy the 
installation's changing needs. 

The examples presented in this publication are for illustra¬ 
tive purposes only; they are not intended for execution. 

For the sake of clarity in examples, user typeins (commands 
and directives) are distinguished from system typeouts 
(responses) by arrows, as shown: 

=> COMMAND LINE 

SYSTEM RESPONSE 

The following conventions are used to indicate the relative 
levels of topic headings used in this manual: 

Level 1 (highest) ALL CAPITALS, UNDERLINED 
Level 2 Initial Capitals, Underlined 

Level 3 ALL CAPITALS, NOT UNDERLINED 

Level 4 Initial Capitals, Not Underlined 

Symbols used in this manual are described below: 

• Brackets [] indicate an optional directive entry. 

• Braces { } enclose information from which a choice must be 
made. 

• The character A indicates a space. 
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MANUAL DIRECTORY 


The following publications constitute the GCOS 6 MOD 400 
manual set. See the "Manual Directory" of the MOD 400 Software 
and Documentation Directory for the revision number and addenda 
(if any) of release-specific editions. 

Manuals are obtained by submitting a Honeywell Publications 
Order Form to the following address: 

Honeywell Information Systems Inc. 

47 Harvard Street 

Westwood, MA 02090 

ATTN: Publications Services 

Honeywell software reference manuals are periodically updated 
to support enhancements and improvements to the software. Before 
ordering any manual listed below, the customer should refer to 
the MOD 400 Software and Documentation Directory to obtain 
information concerning the specific edition of the manual that 
supports the software currently in use at the installation. When 
specifying manuals on the Publications Order Form, a customer 
using the 4-digit base publication number listed below will 
obtain the latest edition of the manual currently in stock. The 
Publications Distribution Center can provide specific editions of 
publications only when supplied with the 7- or 8-character order 
number described in the Software and Documentation Directory. 

Honeywell applications software packages - such as INFO 6, 
TOTAL 6, and TPS 6 - provide specialized services. See your 
Honeywell representative for information concerning the avail¬ 
ability of applications software and supporting documentation. 
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AT97 Level 6 Communications Handbook 

CC71 Level 6 Minicomputer Handbook 

CD18 Level 6 MOD 400/600 Online T&V Operator's Guide 

FQ41 Writable Control Store User's Guide 

Additionally, the user should be aware that a software 
release bulletin accompanies each software product item ordered 
from Honeywell. The user should consult the software release 
bulletin before using the software. See your Honeywell represen¬ 
tative if a copy of the software release bulletin is not 
available. 
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SECTION 1 


SYSTEM BUILDING OVERVIEW 


System building consists of several discrete operations, each 
described in different sections of this manual. The purpose of 
this section is to place these operations into perspective, and 
to enable you to obtain a general view of the system building 
process. 

Honeywell delivers a disk volume containing the software you 
ordered plus an operating MOD 400 Executive. System building 
consists of specifying your system variables, identifying your 
peripheral devices and (optional) communications environment and 
tailoring main memory to suit system and user needs. A "system 
build," starting with the initially supplied system, consists of 
the operations described below. 

PRELIMINARY CONSIDERATIONS 


Before starting to build your system, you must take stock of 
the hardware in your configuration. You must be familiar with 
the characteristics of each peripheral and (optional) communica¬ 
tions device. You must also be aware of what software packages 
you wish to build into your system, consulting the appropriate 
software manuals as necessary. These preliminary considerations 
are discussed in more detail in Section 2. 

INITIAL SYSTEM STARTUP 

System building is a progressive process and is typically 
performed in three discrete stages, each of which is initiated by 
an appropriate type of system startup. To build your new MOD 400 
system, you must first start up the initially supplied system on 
your hardware configuration. The system is designed to start up 
without difficulties on most hardware configurations. 

The three stages of system startup, and the purpose of each 
stage, are described in Section 3. Each stage of system startup 
involves (1) bootstrapping the system from disk into main memory, 
(2) execution of the Configuration Load Manager (CLM) which reads 
a file of CLM directives and causes the system to be configured 
accordingly, and (3) creation of a system task group. As 
described in Section 3, additional actions are possible at system 
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startup, depending on whether a special file (named START UP.EC) 
exists in the initial working directory of the system tasK group. 

SYSTEM BUILDING 

System building consists of creating a file containing a 
series of system building directives which completely specify the 
characteristics of the system. These characteristics include the 
hardware options and physical memory present in the central pro¬ 
cessor, the complement of peripheral and communications devices 
present in your configuration, and the manner in which memory is 
to be allocated among system and application tasks. (The system 
building directives are described in detail in Sections 5 and 6). 

You create this directive file on disk, using either an 
* interactive building program or the standard text editor. Once 
created, the file contains configuration directives, which when 
executed, will configure a system that corresponds to the actual 
installation hardware. 

HOW TO USE THIS MANUAL 

Sections 1, 2, and 3 should be read carefully before you 
begin system building procedures. Sections 1 and 2 provide a 
general description of system building and outline the informa¬ 
tion a first-time user needs to know before bpilding a special¬ 
ized system. Section 3 describes the three stages of system 
startup that must be followed to create an operating environment. 

An interactive CLM directive generation program, called 
M4_SYSDEF, is provided for your convenience in creating the CLM 
directive file, and is fully described in Section 4. Using 
M4_SYSDEF according to directions will result in a syntactically 
correct file of CLM directives. 

Non-communications CLM directives and communications CLM 
directives, used to specify the system configuration, are 
described in detail in Sections 5 and 6, respectively. Refer to 
these sections when creating or modifying your specialized CLM 
directive file. If your system supports communications devices, 
you should be familiar with the Communications Processing manual. 

Section 7 describes the contents of the system release media. 
Typically, an installation will receive all of its system soft¬ 
ware (including any separately priced "extensions" that have been 
ordered) on one type of release medium; that is, on one or two 
cartridge disks, on one mass storage unit (also called a "storage 
module"), on one cartridge module disk, or 6n multiple diskettes. 

Section 8 comprises a number of miscellaneous technical 
notes, most of which pertain only to certain installation sites. 

It is important that each prospective system builder familiarize 
himself with the contents of Section 8 and ascertain which of its 
topics apply to his installation, before he attempts to use the 
system. 
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Most of the appendices in this manual also describe subjects 
of interest only to certain installation sites. Among these sub¬ 
jects are configuration information regarding the Data Entry 
Facility-I (DEF-I), the Remote Batch Facility (RBF) , and file 
transmission. 

Appendixes H, J, and K present configuration information for 
the IBM Workstation Facilities and the Programmable Facility/ 
3271. Appendix L describes Listener and Login capabilities. 

An M4_SYSDEF checklist is supplied for your convenience in 
Appendix M. Use this list as a guide when defining your system's 
resources prior to invoking the M4 SYSDEF program. 

Appendix N describes how to configure the error logging 
capability so your installation can monitoi? memory and device 
performance . 

Appdendix P describes configuration procedures for the Dis¬ 
play Formatting and Control software. This software provides the 
forms processing capability for your installation. 

In general, this manual does not include conceptual informa¬ 
tion; instead, where necessary, see the System Concepts manual 
and/or a manual specific to the desired subject area. Commands 
mentioned in this manual are described in the Commands manual. 
Those operator commands that are not available"to the general 
user community, for example the CSD (change system directory) 
operator command, are described in the Operator's Guide . System 
macro calls are described in the System Service M a cro Calls 
manual. ~ ~ 
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SECTION 2 


PRELIMINARY CONSIDERATIONS 


Before you actually begin to build your system, you should 
first compile the information you'll need to configure the system 
to your specifications. The categories of information required 
are broken into hardware, software, and communications considera¬ 
tions and are discussed further below. Figure 2-1 is a flowchart 
of the recommended procedure for gathering information. 
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Figure 2-1. 


Preliminary Considerations 


Flowc hart 
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HARDWARE CHARACTERISTICS 


You must have available the hardware characteristics of the 
devices in your configuration. You can obtain this information 
by consulting the appropriate hardware reference manuals as 
necessary. 

Specifically, for the central processor, you must know: 

• The model number 

• Whether the central processor is a commercial model 

• Whether the central processor includes the Scientific 
Instruction Processor 

• The size of main memory 

• The number of multiline/dual-line communications 
processors (MLCPs/DLCPs) 

• If an MMU is included 

For peripheral devices, you must know: 

• The maximum number of devices that you want to configure 
(regardless of how many are on the bus) 

• How many of each type of peripheral device you have in 
your configuration, identified by marketing identifier 
(see Appendix C) 

• For terminals, you must know the transmission modes, line 
speeds, desired I/O characteristics, and modem types 

• For disk devices, you must know whether each cartridge 
disk or cartridge module disk has a fixed and removable 
platter; you must also know the storage capacity of each 
device 

• For tape drives, you must know the recording density and 
number of tracks 

SOFTWARE CHARACTERISTICS 


Once you have compiled a list of hardware characteristics, 
you should proceed to gather information on the software char¬ 
acteristics of your configuration. You must determine what soft¬ 
ware subsystems your installation will use. Equipment require¬ 
ments and characteristics of individual software packages are 
available in the appropriate software reference manuals. 
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Specifically, you must know: 

• The text strings you wish to use as the system and 
installation identification of your system 

• The anticipated maximum number of concurrent users 

• The largest logical file number and logical resource 
number available to users 

• The anticipated number of 512-word system overlay areas 

• Whether or not the system will include a batch memory 
pool (and its size) 

• Whether the system will include the commercial or scien¬ 
tific instruction simulators 

• Whether or not the system will incorporate record lock¬ 
ing or Display Formatting and Control software 

• A coherent assignment scheme for symbolic peripheral 
device names, channel numbers, communications priority 
levels, and logical resource numbers (see the System 
Concepts manual) 

• The number of communications line protocols (the recom¬ 
mended maximum is two per MLCP/DLCP) 

COMMUNICATIONS CHARACTERISTICS 

If you intend to include communications devices in your 
configuration, you must read the Communications Processing 
manual first, and be thoroughly familiar with the hardware and 
software characteristics of your communications devices. 

Specifically, you must know: 

• Which protocols you need 

• For polled VIP devices (VIP7700 or VIP7804), a poll 
address scheme, device type, which stations are control/ 
tributary stations, and characteristics of any receive- 
only printers 

• For H3270 Host Links, a poll address scheme, a select 
address scheme, and a communications priority level for 
each line 

• A priority level sharing scheme 

• The number of channel control programs per MLCP/DLCP 
(the recommended maximum is two) 
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• For asynchronous terminals, the communications priority 
level and device type for each 

• For BSC lines, the communications priority level and the 
number of primary and/or secondary lines 

• For ACU channels, the lrn of the station associated with 

each ACU and the list of telephone numbers associated with 
each data communications channel * 

• For stations driven by a user-written line protocal 
handler, whether the line is full- or half-duplex, and the 
lph-specific word for each station 


• For teleprinter compatible devices, the communications 
priority level and modem type for each device 


• Which communications stations will be accessible through 
the file system 

• The polling scheme on a line serviced by the synchronous 
terminal driver line protocol handler 

• For polled or nonpolled VIP terminals, the lrn, level, 
and channel 

• For IBM workstations on a line serviced by the HASP line 
protocol handler, the lrn, level, and channel 

• For stations on a line serviced by the Remote Computer 
Interface line protocol handler, the lrn, level, and 
channel. 

This is only meant to be a representative sampling of some of the 
software and hardware characteristics of which you must be aware. 
For a full description of each communications protocol , see 
Section 6. 
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SECTION 3 


SYSTEM STARTUP 


System startup consists of the following steps: 

1. The system is bootstrapped into main memory as the re¬ 
sult of a procedure performed at the central processor's 
control panel . 

2. The Configuration Load Manager (CLM) , a system component, 
reads a file of CLM directives, which causes the system 
to be configured according to the contents of the 

directives. 


3. A system task group ($S) is created after system config¬ 
uration is completed. If the initial working directory 
for the system task group contains a file named 
START_UP.EC, the operator commands in that file are exe¬ 
cuted to further establish the environment that is 
desired at the end of system startup. (For example, 
the START_UP.EC file may contain operator commands that 
spawn additional task groups.) 

Thus, system startup establishes an operating environment and 
brings the system to a "ready" state, at which point system oper¬ 
ations may begin. 
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There are three stages of system startup. 


1. Stage 1 Initial System Startup, which is performed at 
system installation.7 This type of startup is used to 
establish a limited environment that will allow you to 
use the interactive CLM directive generation program 
M4_SYSDEF or the Editor to create your own file of CLM 
directives. During a stage 1 system startup, the Con¬ 
figuration Load Manager reads one of two supplied files 
of CLM directives that define a limited environment. 

The file of CLM directives read by the Configuration 
Load Manager depends on which of the following situa¬ 
tions exists at system startup: 

a. Bootstrap volume is a cartridge disk, cartridge 
module disk, diskette, or mass storage unit; one 
or more terminals are connected to an MDC. 

b. Bootstrap volume is a cartridge disk, cartridge 
module disk, diskette, or mass storage unit; no 
terminal is connected to an MDC, but one or more 
terminals are connected to an MLCP/DLCP. 

In a stage 1 system startup, the initial working direc¬ 
tory for the system task group is SID. This working 
directory contains a START UP.EC file that causes a 
second task group ($H) to He spawned. 2 

2. Stage 2 Intermediate System Startup. This stage of 
system startup is used after you have created your own 
file of CLM directives, i.e., a file named CLM__USER 
(under SID), which describes your own installed hard¬ 
ware configuration and other details of the environment 
you wish to use for application development. (You will 
have created CLM USER by using M4 SYSDEF or the Editor 
in the limited environment establTshed as the result of 
a stage 1 system startup.) 

In a stage 2 system startup, your tailored CLM_USER 
file must exist under directory SID on the bootstrap 
volume. The Configuration Load Manager will read this 
file instead of the one selected during a stage 1 
system startup. 


i"A' stage 1 system startup can also be used at a later time, in 
the event that an error in a user-created file of CLM directives 
prevents a successful stage 2 or stage 3 system startup. See 
"Bootstrap Options" later in this section. 

2 >SID>START_UP.EC is reserved for use during a stage 1 system 
startup. 
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In a stage 2 system startup, the initial working direc¬ 
tory for the system task group is the root directory of 
the bootstrap disk. This working directory contains a 
START_UP.EC file that causes a second task group ($H) 
to be - spawned. 

Following a stage 2 system startup, application develop¬ 
ment can proceed in an environment you have defined to 
match your own resources and needs. When you have 
reached a point where you wish to define a fully spec¬ 
ialized system refined to precisely match your require¬ 
ments for a standard operating environment, you can use 
the M4_SYSDEF program in Rebuild mode or the Editor to 
modify the contents of CLM USER so that they describe 
your final system. In addTtion, you can modify (or 
delete) the START_UP.EC file of operator commands imme¬ 
diately subrodinate to the root directory of the boot¬ 
strap volume. Note that "refining" takes place over a 
period of time, as you gain experience with the system. 

3. Stage 3 Fully Specialized System Startup. This stage 
of system startup Is used after you have made final ad¬ 
justments to the CLM directives in the CLM_USER file and 
any necessary modifications to the START_UP.EC file. 

This stage of system startup is used to achieve your 
final configuration, one that reflects your total hard¬ 
ware environment, optimized use of central processor 
main memory, and all other characteristics of your 
standard system. 

Once a satisfactory CLM_USER file and START_UP.EC file 
(if any) have been established, this type of system 
startup can be performed routinely, even by noncomputer 
personnel. 

Figure 3-1 summarizes the three stages of system startup. 

STAGE 1 INITIAL SYSTEM STARTUP WHEN PERFORMED 


ONE OF TWO HONEYWELL-SUPPLIED 
FILES OF CLM DIRECTIVES IS USED 
TO DEFINE A LIMITED ENVIRONMENT 
IN WHICH M4_SYSDEF OR THE EDITOR 
CAN BE RUN TO CREATE AN 
INSTALLATION-SPECIFIC FILE OF 
CLM DIRECTIVES. 

(>SID>START UP.EC FILE IS EXE¬ 
CUTED FOLLOWING CONFIGURATION.) 


ONCE AT SYSTEM INSTALLATION. 
THEREAFTER, IF NECESSARY, TO 
PERMIT CORRECTION OF ERRORS IN 
USER-CREATED FILE OF CLM 
DIRECTIVES. 


Figure 3-1. Stages of System Startup 
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STAGE 2 INTERMEDIATE SYSTEM WHEN PERFORMED 

STARTUP 

USER-CREATED FILE OF CLM 
DIRECTIVES, CLMJJSER, IS USED 
TO DEFINE AN ENVIRONMENT IN 
WHICH APPLICATION DEVELOPMENT 
CAN BE PERFORMED. ("ROOT 
DIRECTORY>START UP.EC FILE" IS 
EXECUTED FOLLOWING 
CONFIGURATION.) 

STAGE 3 FULLY SPECIALIZED 
SYSTEM STARTUP 

FULLY SPECIALIZED FILE OF CLM WHEN STANDARD SYSTEM OPERA- 

DIRECTIVES (ADJUSTED CLM USER) TIONS ARE FEASIBLE, AFTER 

IS USED TO DEFINE THE STANDARD NECESSARY APPLICATIONS HAVE 

ENVIRONMENT FOR FULL SYSTEM BEEN CREATED FOLLOWING A 

OPERATIONS. (IF PRESENT, STAGE 2 SYSTEM STARTUP. A 

"ROOT_DIRECTORY>START_UP.EC STAGE 3 SYSTEM STARTUP CAN BE 

FILE IS EXECUTED FOLLOWING PERFORMED ROUTINELY AFTER 

CONFIGURATION.) SATISFACTORY CLM_USER HAS BEEN 

ESTABLISHED. 

Figure 3-1 (cont). Stages of System Startup 

STAGE 1 SYSTEM STARTUP (INITIAL SYSTEM STARTUP) 

A stage 1 system startup causes the system to be boot¬ 
strapped, the Configuration Load Manager to configure the system 
using an existing file of CLM directives, and the operator com¬ 
mands in the >SID>START UP.EC file to be executed. The result 
is a limited system environment that allows you to use the inter¬ 
active CLM directive generation program M4_SYSDEF or the Editor 
to create your own file of CLM directives. - 

The environment achieved by a stage 1 system startup is as 
follows: 

• A removable cartridge disk, cartridge module disk, a mass 
storage unit, or a diskette (depending on the device from 
which the system was bootstrapped). 

• Either an MDC-connected operator terminal or an MLCP/DLCP 
connected operator terminal. (The former is used, if 
present.) 

• One online memory pool and one online task group ($H), in 
addition to the system memory pool and system task group 
($S) . 

A stage 1 system startup consists of the following steps: / 

V 

1. Set the central processor control panel POWER switch 
to ON and turn on the power for all devices. 

3-4 


ONCE AT SYSTEM INSTALLATION, 
AFTER CREATION OF CLM_USER 
FOLLOWING A STAGE 1 SYSTEM 
STARTUP. THEREAFTER, AS 
NECESSARY. 


CB23-03 



2. Mount the volume containing the Honeywell-supplied 
system software on the bootstrap device (cartridge disk, 
cartridge module disk, mass storage unit, or diskette). 

3. Perform the following bootstrap procedure at the central 
processor control panel: 


a. Press Stop. 

b. Press CLeaR. 

c. Press Load. 


d. Press Execute. 


e. Wait for the TRAFFIC light to turn off. (If the 
bootstrap channel is not 0400 and/or if any of the 
bootstrap options described in Table 3-2 are to be 
used, see "Operator's Startup Actions," later in this 
section.) 

f. Press Ready 

g. Press Execute. 

The system is bootstrapped into main memory. Depend¬ 
ing on the terminal configuration, one of the two 
supplied files of CLM directives under directory SID 
is read by the Configuraration Load Manager and the 
system is configured accordingly. 

(1) CLM MDC is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass stor¬ 
age unit, or diskette; one or more terminals 

are connected to an MDC. 

(2) CLM_MCP is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass stor¬ 
age unit, or diskette; one or more terminals 

are connected to an MLCP/DLCP. 

If your configuration includes both MDC- and MLCP/ 
DLCP connected terminals, the system uses CLM_MDC. 

A system task group ($S) is spawned. The operator 
commands in >SID>START_UP.EC are executed, and a user 
task group ($H) is spawned. 

If your configuration includes a terminal connected 
to an MDC, system startup is now complete. Other¬ 
wise, your configuration must include a terminal 
connected to an MLCP/DLCP and you must perform steps 
h, i, and j (full control panel required). 
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h. Wait for the TRAFFIC light to turn off. (If the 
terminal's line speed should be other than 0110 bits 
per second- the default value -enter the appropriate 
line speed in the Rl-register. See the paragraph 
below and Table 3-1.) 

i. Press Ready. 

j. Press Execute. 

The operator terminal is selected as follows: 

1. If there are one or more terminals connected to an 
MDC, the one with the lowest channel number is 
selected. 

2. If there are no terminals connected to an MDC, there 
must be one or more terminals connected to an MLCP/ 
DLCP. In this case, the MLCP/DLCP-connected terminal 
with the highest channel number is the operator 
terminal. 


Since a communications terminal can run at different 
line speeds, you must determine the correct line 
speed of the terminal with the highest channel number 
and then, in the procedure described above, when the 
TRAFFIC light turns off in step 3h, you enter the 
correct line speed in the Rl-register. The default 
value is 0110 bits per second. 


Completion of system startup is signaled by the message shown 
in Figure 3-2. If your terminal is connected to an MDC, don't 
press any terminal keys until after the system startup message 
appears. If you do, you can recover by pressing the BREAK key. 


($S)GC0S6 MOD400 - arrr - mm/dd/hhnn 
($H)$H Group ready! 


NOTE: See the accompanying text for an explanation 

of the variables in the first line. 


Figure 3-2. System Startup Typeout at Operator Terminal 

The system startup message, shown in Figure 3-2, is inter¬ 
preted as follows: 

• ($S)GC0S6 MOD400 - arrr - mm/dd/hhnn 

Indicates the completion of system startup. a is S for a 
SAF system, L for a LAF system. rrr indicates the release 
number of the system Executive, mm/dd/hhnn indicates the 
date/time when the Executive was linked (month, day, 
hours, minutes) . 
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• ($H)$H Group ready! 


Indicates that a user task group, which has the command 
processor as its lead task, is ready for the entry of com¬ 
mands. This task group has been spawned by a command in 
>SID>START_UP.EC. The typeout is the result of a command 
in the supplied >HIS>START_UP.EC file. 

Table 3-1. TTY Terminal Line Speeds 




Type 2100 

, 2110, or 2118 

Type 2108 

Communications-Pac 

Communications-Pac 


Speed 


Speed 

(Entered 

in Rl-Register) 

(Entered 

in Rl-Register) 


0050 


0050 


0075 


0075 


0110 


0110 


0134 


0134 


0150 


0150 


0300 


0200 


0600 


0300 


0900 


0600 


1200 


1050 


1800 


1200 


2400 


1800 


3600 


2000 


4800 


2400 


7200 


4800 


9600 


9600 


NOTE: A speed of 0134 represents 134.5 bits/second. 


STAGE 2 SYSTEM STARTUP (INTERMEDIATE SYSTEM STARTUP) 

A stage 2 system startup can be performed only after you have 
created your own file of CLM directives, named CLM_USER under 
directory SID on the bootstrap volume. The contents of CLM_USER 
should describe the environment you wish to use for application 
development. 

Creating CLM-USER 

The recommended approach for creation of CLM USER is shown 
below. ~ 
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1. Following a stage 1 system startup, invoke M4_SYSDEF to 
run under task group $H. Although you can create the 
CLM_USER file directly by using the Editor, Honeywell 
recommends that you use M4_SYSDEF, the interactive 
system building program, even if you have built the 
system before. See Section 4 for a complete descrip¬ 
tion of how to use M4_SYSDEF. 

2. After creating a CLM USER file using M4_SYSDEF and 
placing it immediateTy subordinate to directory SID on 
your bootstrap volume, continue with the steps necessary 
for a stage 2 system startup. 

If you wish to create your own CLM_USER file without using 
M4_SYSDEF, or if you wish to modify the existing CLM file to 
reflect changes in your installation's configuration, follow 
steps 1 through 7 below to use the Editor. 

USING THE EDITOR 

1. Following a stage 1 system startup, invoke the Editor to 
run under task group $H. 

You may be required to change the default task group of 
the operator's terminal from the $S (System) task group 
to the $H task group. Enter the following lines at the 
operator's terminal immediately following system startup: 

ACA:$H: (transfers default task group of the 

operator's terminal from $S to $H task 
group) 

RDN (The ready on (RDN) command causes a 

prompt message to appear at your 
terminal. This command is for con¬ 
venience only and is not required) 

If you have entered RDN, the system will respond with the 
prompt message: 

($H)RDY: 

Note that no prompt message appears unless you speci¬ 
fied RDN. 

You are not ready to invoke the Editor, as described in 
the Commands manual and the Program Preparation manual. 
Sample Editor work sessions are provided in the 
Programmer's Guide . 

2. If you are modifying an existing CLM file, use the Edi¬ 
tor's read directive to read the file's contents into the 
Editor's "current buffer." If you are creating a CLM 
file, go to step 5. 
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3. Use the Editor's print directive to print out the entire 
contents of the current buffer. 

4. Inspect the printout and identify the differences between 
the contents of the current buffer and your desired file 
of CLM directives. 

5. Use the Editor's insert, change, append, and delete 
directives to modify the contents of the current buffer 
so as to define the CLM directives that describe your 
application development configuration. 

6. Use the Editor's print directive to print out the entire 
contents of the current buffer. Ensure that the contents 
accurately reflect your desired CLM directives. (If any 
corrections are necessary, repeat steps 5 and 6.) 

7. Use the Editor's write directive to write the entire con¬ 
tents of the current buffer to >SID>CLM_USER. (You may 
give your CLM file any name you wish, although it is 
recommended that you call it CLM USER. Note that the 
Configuration Load Manager must be able to locate a file 
named CLM_USER at system startup. 

Stage 2 Startup 


Once you have defined the desired contents of >SID>CLM_USER, 
you can perform a stage 2 system startup by taking the following 
steps : 

1. Ensure that the central processor control panel's POWER 
switch is ON and turn on power to all equipment. 

2. Ensure that the volume containing the Honeywell-supplied 
system software is mounted on the bootstrap device. 

3. Perform the following bootstrap procedure at the central 
processor control panel: 

a. Press Stop. 

b. Press CLeaR. 

Wait for CHECK light to go out. 

c. Press Load. 

d. Press Execute . 

e. Wait for the TRAFFIC light to turn off. (If the 
bootstrap channel is not 0400 and/or if any of the 
bootstrap options described in Table 3-2 are to be 
used, see "Operator's Startup Actions," later in this 
section.) 
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f. Press Ready. 

g. Press Execute. 

The system is bootstrapped into main memory. The 
CLM_USER file in directory SID is read by the Config¬ 
uration Load Manager and the system is configured 
accordingly. 

A system task group ($S) is spawned. The operator 
commands in the Honeywell-supplied ~root_directory 
>START_UP.EC file are executed, causing a user task 
group ($H) to be spawned. 

System startup is complete. The system startup message is 
issued at the operator terminal, which, in the case of a stage 2 
system startup, is the terminal associated with logical resource 
number (lrn) 0 in a CLM directive. (If the operator terminal is 
connected to an MLCP/DLCP, the terminal's line speed and other 
communications characteristics are defined in a CLM directive.) 


If a CLM directive in CLM_USER contains an error caused by 
incorrect syntax or if the CLM directive is an invalid duplicate, 
an error message will appear at the operator terminal (if possi¬ 
ble) . See "Configuration Load Manager Error Reporting" at the 
end of this section. If an uncorrectable error prevents success¬ 
ful completion of a stage 2 system startup, it is possible, by 
means of the appropriate bootstrap option (see Table 3-2), to 
bypass the CLM USER file and perform a stage 1 system startup 
using one of the two supplied files of CLM directives. This 
technique allows you to re-establish a limited system configura¬ 
tion in which you can use the Editor or M4_SYSDEF to correct 
CLM USER before reattempting a stage 2 system startup. 


Note 
ordinate 
modified 


also that the supplied START_UP.EC file directly sub- 
to the bootstrap volume's root directory is normally not 
prior to a stage 2 system startup. 


Once a satisfactory stage 2 system startup has been achieved, 
you can use the resulting system for application development or 
as a means of gaining experience in the use of the system 
software. 


STAGE 3 SYSTEM STARTUP (FULLY-SPECIALIZED SYSTEM STARTUP) 

A stage 3 system startup is very similar to a stage 2 system 
startup. The principal difference is that application develop¬ 
ment performed following a stage 2 system startup provides you 
with information you may wish to use in refining the CLM direc¬ 
tives in your CLM USER file. For example, you may wish to change 
certain MEMPOOL dTrectives and/or cause certain system overlays 
to be made permanently resident. Moreover, you may wish to 
describe additional peripheral devices that were not previously 
identified in CLM_USER because they were not used during applica¬ 
tion development. 
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Thus, prior to performing a stage 3 system startup, you will 
probably have used the Editor or M4_SYSDEF to update the contents 
of CLM_USER. Additionally, you must decide whether to retain, 
modify, or delete the START_UP.EC file immediately subordinate to 
the bootstrap volume's root directory (i.e., the START UP.EC file 
used in a stage 2 system startup). If you wish to retain this 
START_UP.EC file in its original condition (but not use it during 
a stage 3 system startup), you may use the RENAME command. 

The steps performed in a stage 3 system startup are identical 
to those used for a stage 2 system startup except that the 
~root_directory>START_UP.EC file may have been modified or 
deleted. If this file exists at the time of a stage 3 system 
startup, all operator commands therein will be executed. 


SUMMARY OF STARTUP PROCEDURE 

The following paragraphs and Figure 3-3 summarize the startup 
proced ure. 


Every time the system is bootstrapped, a software component 
ascertains whether an initially-supplied or a user-created file 
of CLM directives is to be read by the Configuration Load Man¬ 
ager. If an initially-supplied file is used, a software algo¬ 
rithm also ascertains whether the operator terminal is to be an 
MDC-connected terminal or an MLCP/DLCP-connected terminal. If a 
user-created CLM file is used, a CLM directive dictates which 
device is to be the operator terminal. 


During a system startup in which an initially-supplied CLM 
file is used (i.e., a stage 1 system startup), operator commands 
in the START_UP.EC file in directory >SID will be executed. Dur¬ 
ing a stage 2 system startup (user-created file of CLM directives 
used), operator commands in the supplied START_UP.EC file under 
the bootstrap volume's root directory will be executed. During 
a stage 3 system startup (refined user-created file of CLM 
directives used), operator commands in the START_UP.EC file under 
the bootstrap volume's root directory will be executed if such a 
file is present either in its original form or as modified by the 
user . 
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BOOTSTRAP 



Figure 3-3 


Flowchart of 


System Startup Process 
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CONFIGURATION PHASE 
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SYSTEM GROUP 
STARTUP PHASE 


Figure 3-3 (cont) . 


Flowchart of 


System Startup Process 
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SYSTEM GROUP 
STARTUP 



USER GROUP IS 
NOW READY 


Figure 3-3 (cont) . 


Flowchart of 


System Startup Process 
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Operator's Startup Actions 


The operator's actions at system startup are as follows: 

1. Set the central processor control panel POWER switch 
to ON. Turn on power for all devices. 

2. Ensure that the volume containing the Honeywell- 
supplied system software is mounted on the bootstrap 
device. 

3. Perform the following bootstrap procedure at the central 
processor control panel: 

a. Press £top. 

b. Press CLeaR♦ 

Wait for CHECK light to go out. 

c. Press Load. 

d. Press Execute. 

e. Wait for the TRAFFIC light to turn off. 

If the bootstrap channel is not 0400 and/or if any of 
the bootstrap options shown in Table 3-2 are to be 


used 

, perform the following steps: 


(1) 

Press Stop. 


(2) 

Press Select. 


(3) 

Press D1 on the hexadecimal keypad, so 
D1 appears in the LOCATION indicators. 

that 

(4) 

Press Change. 


(5) 

Press appropriate keys on the hexadecimal 
keypad so that the CONTENTS indicators show the 
desired bootstrap channel and options. 

(6) 

Press Run. 



f. Press Execute 

The system is bootstrapped into main memory. (If the 
bootstrap halt option was specified in step e(5) 
above, the central processor halts, with D1 equal to 
what was entered in step e(5), as soon as the system 
has been bootstrapped; after performing any desired 
actions, again press Execute to continue. If Stop, 
Run, or Write was involved in these actions, press 
Run and Execute to continue.) 
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(In a stage 1 system startup with an MLCP/DLCP- 
connected operator terminal, wait for the TRAFFIC 
light to turn off; then ensure that the Rl-register 
contains the proper line speed for the operator ter¬ 
minal and press Execute to continue.) 


Table 3-2. Bootstrap Options 


Bits in Low-Order 
Digit of 4-Digit 
Hexadecimal Boot¬ 
strap Channel 
Number 

Meaning if Bit Set ON a 

15 

(low-order bit) 

After the initial bootstrap record is read from 
the removable platter of the cartridge disk 
whose channel number is contained in bits 0 
through 9, the remaining records are read from 
the fixed platter. 

14 

Ignore CLM USER file if it exists under direc¬ 
tory SID. “instead, use the supplied file of 

CLM directives appropriate to the bootstrap 
device and terminal configuration (i.e., 

CLM MDC or CLM__MCP.) 

13 

The central processor halts after the system is 
bootstrapped and before execution of the Execu¬ 
tive begins, and before execution of CLM. (To 

continue after the halt, press Execute.) 

a These bits may be set ON in any desired combination. Thus, the 
value of the low-order digit of the 4-digit hexadecimal boot¬ 
strap channel number may range from 0 (no options) to 7 (all 
options). 


System Startup Actions 


System startup actions continue without further operator 
intervention. 

1. The Configuration Load Manager reads CLM directives from 
the appropriate file: 

a. If CLNMJSER does not exist in directory SID on the 
bootstrap volume, one of the two Honeywell-supplied 
files is used. 

(1) CLM_MDC is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass 
storage unit, or diskette, and one or more ter¬ 
minals are connected to an MDC. (The terminal 
with the lowest channel number will be used as 
the operator terminal.) 
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(2) CLM_MCP is used if the bootstrap volume is a 
cartridge disk, cartridge module disk, mass 
storage unit, or diskette, and one or more ter¬ 
minals are connected to an MLCP/DLCP. (The 
terminal with the highest channel number will be 
used as the operator terminal.) 

b. If CLMJJSER doe s exist under directory SID on the 
bootstrap volume, it will be used unless bit 14 of 
the bootstrap channel is set ON, in which case one 
of the system actions described under a (above) is 
followed. 


2. The system task group is created as if the following 
command had been executed, without user intervention: 


$S 

OPERATOR.SYSTEM.OPR 

highest priority level 
+ 2 in CLM directive 

!CONSOLE 


-ECL 

-LRN highest lrn in 
CLM directive 

-LFN 15 

-POOL system pool 

-WD , 'root_directory if 

CLM directives were 
read from CLM_USER; 

SID if CLM direc¬ 
tives were read 
f rom 

CLM MDC or CLM MCP 


(spawn group command) 
(task_group_id ) 

(use r _id) 

(base_prio rity_level) 

(in_path, also 
out_path by default) 

(lead task) 

(highest lrn) 

(highest lfn) 

(memory pool) 

(initial working 
directory) 


3. A system-supplied START_UP.EC file is in directory SID; 
its operator commands are executed when a stage 1 sys¬ 
tem startup is performed (i.e., when CLM directives are 
read from CLM_MDC or CLM_MCP). Another system-supplied 
START_UP.EC file is immediately subordinate to the root_ 
directory of the bootstrap volume; its operator commands 
are executed when a stage 2 system startup is performed. 
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Both START_UP.EC files cause a user task group ($H) to 
be spawned. The working directory for $H is HIS, which 
in turn contains a system-supplied START_UP.EC file 
that performs a CWD (change working directory) to 
~root_directory. 

Regardless of which file of CLM directives is used, the 
working directory for the system task group is always 
~root_directory at the end of system startup. 

4. The system startup typeout (see Figure 3-2) is issued at 
the operator terminal. 

When system startup is complete, as signified by the system 
startup typeout, operator commands may be entered to the system. 

CONFIGURATION LOAD MANAGER ERROR REPORTING 

If, when the Configuration Load Manager is reading CLM di¬ 
rectives from CLM_USER, it detects that a directive contains a 
syntax error or is an invalid duplicate of another CLM directive, 
it issues (if possible) a 2-line error message at the operator 
terminal. The message has the format shown below: 

($S) (13yyzz) hh 

secondary message indicating the CLM directive causing 

the error 

yy - code identifying the system component that has 
detected the error 

zz - error code (see the System Messages manual) 

hh - priority level of the task group executing the 
Configuration Load Manager 

You can (if appropriate) bypass the error by typing * (as¬ 
terisk) at the operator terminal and pressing RETURN. Other¬ 
wise, you must enter a correct CLM directive through the oper¬ 
ator terminal and press RETURN. The remainder of the CLM 
directives in CLM_USER will then be processed. 

An error message cannot be issued if an operator terminal is 
not available because (1) the CLM DEVICE directive for an MDC- 
connected operator terminal has been omitted or (2) the operator 
terminal is connected to an MLCP/DLCP in which case it is not 
operational until system startup is complete or (3) the error 
occurred before the DEVICE directive defining the console was 
read. (For this reason, it is important to place the directive 
early in the CLM_USER file.) In these cases, errors are 
reported through - the hardware registers shown below, which are 
accessible through the central processor control panel. Refer to 
Section 5 in the Minicomputer Systems Handbook (CC71) for pro¬ 
cedures to follow in reading out reg isters ancf memory locations. 
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Rl-register contains yyzz (as described above) 

•R2-register zero or a 1-word secondary message in hexa¬ 
decimal notation 

B4-register zero or the address of the first word of a 
secondary message in ASCII notation (the 
left byte of this word is a control byte) 

B3-register zero or the address of the first word of the 
CLM directive causing the error provided the 
error occurred before the QUIT directive 

As described earlier in this section, in the event of an 
uncorrectable error in CLM USER, it is possible to return to a 
stage 1 system startup (using the appropriate bootstrap option) 
and re-create a limited system environment in which M4 SYSDEF or 
the Editor can be used to correct the error in CLM_USE1T. 

See Appendix A for information about other halts that are 
possible during system startup. 


4 

1 



3-19 


CB23-03 








SECTION 4 
USING M4 SYSDEF 


M4_SYSDEF, an interactive program that generates a CLM direc¬ 
tive file, is provided for your convenience in creating the 
CLM_USER file, and is fully described in this section. 

The system building CLM directives themselves are described 
in detail in Sections 5 and 6. Note that some of the direc¬ 
tives - and thus some of the MOD 400 software - are not supported 
by M4_SYSDEF. See "M4_SYSDEF Operating Considerations", later in 
this section. 

INTERACTIVE SYSTEM BUILDING PROGRAM 

The interactive CLM directive generation program M4_SYSDEF 
is designed to help you create the CLM directive file CLM_USER. 

It converts information you give it, in response to its prompts, 
into the CLM directive file. M4 SYSDEF is designed to produce a 
directive file adequate for the average user and which will 
always result in an operable MOD 400 Executive. 

Although you can create the CLM directive file directly, 
using the Editor, Honeywell recommends that you use M4_SYSDEF, 
even if you have built the system before, because M4_SYSDEF: 

• Is interactive; it prevents you from forgetting any 
necessary information. 

• Tests each of your responses for validity. 

• Includes online explanations of each of its prompt 
messages . 

• Ensures that a complete, properly ordered directive 
file is produced. 

• Allows you to interactively add, delete, or modify infor¬ 
mation you specify at any point in the program. 
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• Performs all calculations of memory required by your 
Executive; the resulting memory sizes should never be 
less than your requirements. 

• Builds in all hardware devices supported by Honeywell. 

• Generates, at your option, symbolic peripheral device 
names for all devices in your configuration. 

• Generates, at your option, channel number assignments 
for all noncommunications devices in your configuration. 

• Produces, at your option, a listing of the directive file 
at your terminal, before generating the final output file. 

• Automatically generates a file containing configuration 
information that enables you to verify the success of cer¬ 
tain aspects of the system building process. 

• At your option, automatically configures all asynchronous 
communications devices (TTY and ATD) as being reconnect- 
able in the event of a power failure or line drop. 

Appendix M contains a checklist for your convenience in 
gathering the information M4_SYSDEF requires. Appendix C lists 
the hardware available under MOD 400. 

Required Resources 


M4_SYSDEF requires 10K words of memory to operate. It can 
run in the MOD 400 minimum system. 

M4-SYSDEF Operating Considerations 


You should consider the following when executing M4_SYSDEF: 

1. If you allow M4_SYSDEF to dynamically assign channel 
numbers to your devices, you will only need to supply 
channel numbers for MLCP/DLCP - connected (communica¬ 
tions) devices. If you do not choose this option, you 
will be asked to explicitly specify channel numbers for 
all devices in your configuration. (See Section 5 for 
information on dynamically assigned channel assignments 
for non-communications devices.) 

2. If you choose to let M4_SYSDEF supply the channel numbers 
for all non-communications devices: 
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• M4_SYSDEF will assign the channel to be used for the 
operator terminal. If the operator terminal is to 
be an MDC-connected terminal, the program uses the 
device with the numerically lowest channel number as 
the operator terminal. If the operator terminal is 
to be an MLCP/DLCP-connected terminal, the program 
uses the device with the numerically highest channel 
number as the operator terminal. 

• M4_SYSDEF will ask you to specify the type of device 
you plan to use as the boot device. 

If you do not choose to supply symbolic peripheral device 
(SPD) names, M4_SYSDEF automatically generates a unique 
SPD name for evFry device configured. If you choose to 
provide your own SPD names, M4_SYSDEF will ask you to 
specify them as needed. 

Honeywell recommends that you use the following 
symbolic peripheral device (SPD) name conventions if 
you wish to provide your own SPD names: 

Symbolic 
Peripheral 
Device (SPD) 

Name Device 


LPTnn 

Line Printer 

SPTnn 

Serial Printer 

CONnn 

MDC-connected Terminal 

CDRnn 

Card Reader 

CRPnn 

Card Reader/Punch 

DSKnn 

Diske tte 

RCDnn 

Removable Cartridge Disk 

FCDnn 

Fixed Cartridge Disk 

FCMnn 

Fixed Cartridge Module Disk 

RCMnn 

Removable Cartridge Module Disk 

MSMnn 

Mass Storage Unit 

MT9nn 

Magnetic Tape (9-track) 
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4. Honeywell recommends configuring Distributed Systems 
Facilities software e.g., File Transmission Facility, 

HASP Workstation Facility, etc. after you have built your 
system the first time. This software is described in 
this manual's appendices. 

5. M4_SYSDEF doesn't support the following: 

• Configuration of dual-purpose operator terminal 

• User-written line protocol handlers (LPHn) 

• Autocall Unit (ACU) 

• 7-track tape devices 

• Device or memory error logging 

6. The program converts all lowercase characters in your 
responses to uppercase characters, unless you enclose the 
lowercase characters in apostrophes ('). 

7. When you enter channel number assignments, the program 
verifies that: 

• The channel number is in the proper format (i.e., that 
it contains exactly four hexadecimal characters and 
ends with either "00" or "80") 

• The channel number isn't already assigned to another 
device 

® The channel number isn't less than 0400 or greater 
than FF80 

Since there is no requirement that system building take 
place upon the target machine, or that any specified 
device actually be attached to the machine when M4_SYSDEF 
is executed, the program doesn't verify whether the spe¬ 
cified channel is actually connected to a device whose 
type matches the one in question. Therefore, if you 
enter invalid channel number assignments, the directive 
file will be in error. 

MODIFYING YOUR CLM DIRECTIVE FILE 

If you make mistakes in specifying your directives when 
running the M4_SYSDEF program, or, if you wish to change, add, 
or delete information, you have several options for making 
modifications: 
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o You can interrupt the program at any point to modify 
any portion of the CLM file. To do this, enter 
ACAB$H, and following the BREAK message, enter the 
program interrupt (PI) command. (It is assumed that 
you are entering the M4 SYSDEF program from the 
operator's terminal. IF you are not at the operator's 
terminal, press the BREAK key, and Following the BREAK 
message, enter the PI command.) The M4_SYSDEF program 
will respond by asking you which class of device or 
system parameter you wish to modify. Depending on your 
reply, the program will ask you only those questions in 
the M4 SYSDEF dialog that pertain to the specific device 
or sysFem parameter that you wish to modify. 

o You can finish running the program and do one of the 
following: 


- Invoke M4_SYSDEF again, this time specifying the 
pathname of your restart file. The M4_SYSDEF pro¬ 
gram will enter rebuild mode and will ask you to 
specify the class of device or system parameter 

you wish to modify. See "Using M4 SYSDEF in Rebuild 
Mode," below. ~ 

- Invoke M4_SYSDEF again and redefine the entire file. 

- Use the Editor to edit the file directly. 


USING M4_SYSDEF IN REBUILD MODE 

Using the M4 SYSDEF program in rebuild mode allows you to 
enter the program dialog at any point to make changes to an 
existing CLM file. The M4 SYSDEF program will only ask you 
those questions in the dialog that pertain to the specific 
device, class of devices, or system parameter that you wish to 
modify. Because you need not step through the entire M4 SYSDEF 
dialog in sequence to get to the section(s) you wish to modify, 
you can make random modifications quickly and easily. 

The first time you create a CLM file using M4_SYSDEF, the 
program generates a CLM directive file and a file containing 
information for the rebuild function, called the restart file. 
Each time you modify a CLM file, the M4 SYSDEF program creates a 
unique corresponding restart file under - the same directory as 
your CLM file. 1 Whenever you terminate the M4 SYSDEF program 
normally the full pathnames of your CLM file and its correspond¬ 
ing restart file are displayed at your terminal. You never 


'There is no limit to the number of restart files that the 
M4 SYSDEF program creates. You must delete restart files 
which are no longer needed with the delete file (DL) com¬ 
mand, as described in the Commands manual. 
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assign a name to the restart file - the M4_SYSDEF program does 
this for you automatically. You need only be aware of the path¬ 
name of the restart file that corresponds to the CLM directive 
file you wish to modify. 

If you wish to modify a CLM file at some later time, you 
simply invoke M4 SYSDEF and specify the pathname of the corres¬ 
ponding restart Tile on the command line. The M4_SYSDEF program 
reads your restart file and resets itself to the state defined 
in the restart file. See "M4_SYSDEF Dialog In Rebuild Mode" 
later in this section for a complete description of the rebuild 
mode dialog . 

OUTPUT OPTIONS 

You have several output options when using M4 SYSDEF: 

1. You can request M4_SYSDEF to list all the CLM directives 
it has built for you. If you spot any errors at this 
point (or at any point during the interactive dialogue) 
you can perform any one of the actions described above 
under "Modifying Your CLM Directive File". 

2. You have the option of creating a CLM_USER file which 
contains the generated directives or you can terminate 
the interactive session. If you have not listed the CLM 
directives and you do not wish to create a file using 
them, M4_SYSDEF warns you that the directives will be 
lost and processing will terminate, and asks if this is 
what you intend. 

3. You have the option of giving your directive file a name 
other than the default file name CLM_USERj After you 
specify a file name, M4_SYSDEF creates the file under 
your current working directory, assumed to be (but not 
restricted to) directory SID in the rest of this section. 

Invoking M4 SYSDEF 

Before invoking M4_SYSDEF, you are required to transfer con¬ 
trol of the operator's terminal from the $S task group (the 
system operator's task group) to the $H task group (a system- 
supplied user task group). (If the terminal is already under 
control of the $H task group, proceed to the paragraph below that 
describes how to change your working directory to the directory 
SID.) Enter the following lines at the operator's terminal 
immediately following system startup: 


'if a CLM file already exists in your working directory, 
M4_SYSDEF cautions you that your new CLM file will replace 
the existing one, if both have the same file name. 
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ACA:$H: 


(Transfers control of the operator's 
terminal from $S to $H task group) 


RDN (The ready on (RDN) command causes a 

prompt message to appear at your 
terminal. This command is for con¬ 
venience only and is not required.) 

If you have entered RDN, the system will respond with the 
prompt message: 


( $H)RDY: 

Note that no prompt message appears unless you specified RDN. 

Next, change your working directory to the directory SID by 
entering: 


CWD >SID 

Then invoke M4_SYSDEF by entering: 

M4_SYSDEF [path] 

where the optional argument [path] specifies the pathname of a 
system-supplied restart file. The pathname must be of the form 
M4RST.n where n is an integer. You specify this argument only 
if you wish to enter the M4_SYSDEF program in rebuild mode to 
modify an existing CLM file. See "M4_SYSDEF Dialog In Rebuild 
Mode" later in this section. ~ 

You can terminate the interactive session at any time by 
entering ACAB$H and then, following the BREAK message, using the 
unwind (UW) command. (It is assumed that you are at the 
operator's terminal. If you are not at the operator's terminal, 
press the BREAK key, and following the BREAK message, enter the 
UW command.) If you make a mistake while creating the directive 
file, follow one of the options described elsewhere in this 
section under "Modifying Your CLM Directive File." 

Prompt Modes 


M4_SYSDEF operates in two prompt modes - long and short. In 
the long mode, each question is preceded by a multiline onscreen 
explanation of the question being asked. In the short mode, only 
the question is asked. Users of the short prompt mode who need 
help can see the long explanation printed as a "help message" by 
asking for help (see below). 

M4_SYSDEF asks you which mode you want to use when you invoke 
the program. If you select the long mode, the explanatory text 
appears only once. If the program repeats the question (because, 
perhaps, you answered it incorrectly), the short prompt is 
repeated unless you ask for help. It is recommended that first¬ 
time system builders execute M4 SYSDEF in the long prompt mode. 
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M4_SYSDEF DIALOGUE 


The short mode prompt messages which make up the M4_SYSDEF 
dialogue are listed below, in order of their appearance. Unless 
otherwise noted, these responses are always acceptable: 

• ? - Help 

• YES or Y - Yes (for yes/no questions) 

• NO or N - No (for yes/no questions) 

• 0, NONE, or N - None (for questions requiring a numeric 
response) 

A response of [C/R] (RETURN) is ne ver acceptable (i.e., there are 
no default responses). 

Once you invoke M4_SYSDEF, it responds with: 

Hello! This tool will help you generate the file containing the 
Configuration Load Manager directives (the CLMJJSER file), which 
is necessary to build your GCOS6/MOD400 Operating System. Do you 
wish to use the long prompt mode? 

• In the long mode, every prompt message is preceded by the 
text of the "help" message, explaining what the requested 
information is, where you can find out if you have it or 
need it, and/or what will happen if you supply certain 
values. 

In the short prompt mode, only the prompt message is dis¬ 
played, unless you enter ?. Entering ? doesn't change the 
mode . 

• Acceptable answers are YES, Y, NO, or N. 

What is the total amount (in words) of real memory on the machine 
this system is to run on? Enter the value in the form: nnnk. 

• This value is the total amount of real (physical) memory 
installed on the machine for which this sys °m is being 
built. The value you enter may differ fron .he amount of 
memory on the machine on which you invoke Ma_3YSDEF. The 
minimum configuration for MOD 400 is 48K words. 

• Acceptable answers range from 48K to 1024K. Consult 
Appendix C for information about minimum system require¬ 
ments. 
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Do you wish the system to supply the channel numbers for non¬ 
communication devices? 

• Every peripheral device attached to the system must have 
a megabus channel number assignment. The program can use 
the floating channel feature (see Section 5) to relieve 
you of the responsibility of assigning channel numbers to 
noncommunications devices; note, however, that you must 
always provide channel numbers for communications devices. 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply YES, the program will ask you to supply 
device types for the operator's console and the boot 
device. 

• If you reply NO, the program will prompt you to supply a 
channel number for each device in your configuration. 

Enter the channel number of the operator terminal which will be 
the CONSOLE. 

• You must specify the channel to which the operator's ter¬ 
minal is connected. M4_SYSDEF verifies for you that this 
channel number has not already been assigned to another 
device. However, only y ou can verify that the specified 
channel is actually connected to the terminal designated 
as the operator terminal for your installation; M4_SYSDEF 
cannot check this information for you. 

• The channel number specified must consist of four hexa¬ 
decimal characters ending in '00' or '80'. 

Enter the channel number of the boot device. 

• You must specify the channel number of the drive on which 
you mount the disk containing the system software. 

• The channel number specified must consist of four hexa¬ 
decimal characters ending in '00' or '80'. 

• This prompt does not appear if you specified that 
M4_SYSDEF will supply the channel numbers for all 
non-communications devices in your configuration. 

Do you wish to boot the fixed platter? 

• This prompt applies only if you wish to boot from the 
fixed platter of a cartridge disk or cartridge module 
disk. 

• Acceptable answers are YES, Y, NO, or N. 
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Is this a Commercial System? Reply "yes" or "no". 

• If you have a Model 47 or Model 57 central processor, 
answer YES. If you have any other model central pro¬ 
cessor, you must answer NO. 

• Acceptable answers are YES, Y, NO, or N. 

• If you respond NO to this question, the program replies: 

Will this system have a Commercial simulator? 

• If your system isn't a commercial system, it may require 
the commercial instruction simulator. Otherwise, it won't 
be able to execute commercial instructions (used, for 
instance, by intermediate COBOL). 

• Acceptable answers are YES, Y, NO, or N. 

Will this system have a SIP? Reply "yes" or "no". 

• The SIP is the Scientific Instruction Processor software 
option. 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply NO to this question, the program replies: 

Will this system have a simulator for the SIP? Reply "yes" or 

"no" . 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply NO, then the system won't be able to support 
scientific instructions (used, for instance, in FORTRAN). 

• If you replay YES to this question, the program replies: 

Do you want the double precision simulator SIP5IM? 

• Acceptable ansers are YES, Y, NO, or N. 

• If you reply yes, the double-precision simulator will give 
you twice as many significant digits in your FORTRAN cal¬ 
culations as the single-precision simulator. (If you 
chose this option, be aware that numerical values stored 
in memory will take up twice as much space as values 
stored for the single-precision simulator). 
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The default system identification is 'GCOS6/MOD400'. If you wish 
to change it, reply 'YES'; if you do not wish to change it, reply 
'NO' . Do you? 

• The system identification message appears as a comment 
line near the top of the CLM file that M4_SYSDEF generates 
for you. You may, if you wish, customize this message for 
your installation's CLM directive file. 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply YES to this question, the program replies: 

Enter the new System Identification (30 characters or less) in 
the form: 1 S YSTEM_IDENTIFICATION' 

• You must enclose the entire string in apostrophes, as 
shown. 

The default installation identification is 'Your Town, USA'. If 
you wish to change it, reply 'YES'; if you do not wish to change 
it, reply 'NO'. Do you? 

• The installation identification message appears as a 
comment line near the top of the CLM file that M4_SYSDEF 
generates for you. You may, if you wish, customize this 
message for your installation's CLM directive file. 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply YES, the program responds: 

Enter the new installation identification (30 characters or less) 
in the form: 'Installation id' 

• You must enclose the entire string in apostrophes, as 
shown. 


Please enter the maximum number of concurrent users that you 
expect this system to support. 


• This value allows for the calculation of some of the sys¬ 
tem structure sizes and memory needs which vary depending 
upon the maximum load for which the system is to be built. 
M4 SYSDEF assumes that the number of users is synonymous 
wiFh the number of task groups. 




Note that entering a given number here does 
that the maximum number of concurrent users 
be supported. This depends on such dynamic 
the work each user is performing and memory 


not guarantee 

can in fact 
variables as 
fragmentation. 


• Nonnumeric characters are not acceptable in this answer. 
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Should I automatically generate the SPD names for you? 

• Each peripheral device attached to the system must have a 
symbolic peripheral device name. This entry is a five- 
character 1 name which conforms to the file system naming 
conventions . 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply YES, the program will generate 5-character 
SPD names without further prompting. If you reply NO, the 
program will prompt you to supply an SPD name for every 
device in your configuration. 

Do you wish this system to activate the Record Locking Feature of 

Data Management? 

• Record locking is the finest granularity of concurrency 
control provided by data management. Activation of this 
runtime option allows more than one user to write records 
to a given file simultaneously. Proper usage of this 
option ensures that all updates are correctly applied to 
the file. 

® Acceptable answers are YES, Y, NO, or N. 

@ If you reply YES, record locking is implemented. If you 
reply NO, data management will enforce file level con¬ 
currency (i.e., only one user can have write permission 
on a file at one time) . 

Do you wish to include Display Formatting and Control Software? 

® The Display Formatting and Control software is described 
in the D_i_spl ay Formatting a n d Contro l manual and in 
Appendix P of this manual. 

• Acceptable answers are YES, Y, NO, or N. 

® If you replay YES, the display processing software will be 
included in your Executive. If you reply NO, no display 
processing software will be included. 


'Acceptable ranges are from 5 to 12 characters (6 for disks); 
however, for consistency, Honeywell recommends using 5-character 
symbolic peripheral device names. 
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Do you wish to activate the power fail restart? 

• This prompt asks if you wish to configure the power 
resumption facility. The power resumption facility allows 
the system execution environment to be restarted after a 
power interruption, if fewer than two hours have elapsed 
when power is returned to the central processor. For more 
information, refer to Appendix D. 

• If you reply YES, each ATD and TTY communications 
(MLCP/DLCP-connected) device in your configuration will 
be automatically reconnected if a power resumption or 
line drop condition occurs. (Peripheral devices not 
attached to an MLCP/DLCP are automatically designated as 
reconnectable when they are configured.) 

• If you reply NO, no automatic reconnection of MLCP/DLCP- 
connected terminal devices will occur. 

Does this system have any communications type devices? i.e., 

VIP's, TTY's, etc. 

• Acceptable answers are YES, Y, NO, and N. 

• A communications device is an MLCP/DLCP-connected device. 

• If you reply NO, the program skips to the prompt. "How 
many MDC-connected console devices do you have?", later in 
this dialogue. If you reply YES, you will see the follow¬ 
ing prompts. 

How many communications priority levels (1 to 4) do you wish? 

Enter the number of levels. 

• Each device must be assigned to a hardware interrupt 
level. Noncommunications devices must be assigned' to 
unique interrupt levels; M4 SYSDEF can perform this 
assignment for you. HoweveF, communications devices can 
share a priority level; therefore, you are given a chance 
to specify relative priority levels for each communica¬ 
tions device . 

• Acceptable answers are 1, 2, 3, or 4. If you specify 1, 

all communications devices will share one interrupt level. 
If you specify 2 through 4, you will have the capability 
to assign specific devices to different levels, with those 
devices on level 1 having the highest relative priority 
and those devices on level 4 having the lowest relative 
priority. You do not have to assign at least one device 
to each level; M4 SYSDEF reserves any unused levels for 
you. — 


I 
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How many MLCP's (1 to 10) will this system have? 

• All communications devices must be attached to a multi- 
line communications processor (MLCP). 

• Acceptable answers are 1 through 10, inclusive. 

How many ATDs do you have? 

• The program is now attempting to configure all MLCP/DLCP 
connected asynchronous terminal devices. 

• The following asynchronous terminal devices are supported: 
VIP 7200, VIP 7205, VIP 7801, VIP 7802, VIP 7207, PRU1001, 
PRU1003, PRU1005, TWU1001, TWU1003, TWU1005, and various 
teleprinter-compatible devices. 

• If you reply NONE, the program skips to the prompt, "How 
many VIP's do you have?", below. 

• If you reply with a nonzero number, the program continues: 

ATD terminal number N 

• This message, and the three prompts following it, appear 

N times, where N is your response to the earlier question, 
"How many ATDs do you have?". 

What channel number will this device be on? 

• You must enter exactly four hexadecimal characters, ending 
in '00' or ' 80 ' . 

Enter the communications priority level for this terminal. 

• Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 
levels (1 to 4) do you wish?". 

• If you specified only one communications priority level, 
this prompt won't appear. 


/f" 

V 
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What is the device type for this ATD device? 

• You must specify one of the following values (there is no 
default): 

Value Physical Device Type 

7200 VIP 7200, VIP 7205 

7801 VIP 7801, VIP 7802 

D7200 VIP 7207 

PRU PRU 1001, PRU1003, PRU 1005, 

TWU 1001, TWU1003, TWU 1005 

TTY Can be any asynchronous terminal device¬ 

type classified as teleprinter compatible 

How many VIP's do you have? 

• The program is now attempting to configure synchronous 
terminals. The following synchronous terminals are sup¬ 
ported by M4_SYSDEF: 

VIP 7700 

VIP 770OR/VIP 7705R 

VIP 7760 

VIP 7804/VIP 7805 (in VIP 7700 mode) 

• To use the extended features of the VIP 7804 or VIP 7805, 
you may want to use an STD directive. STD groups are 
configured later on in the M4_SYSDEF dialog. 

• If you reply 0, the program skips to the prompt, "How 
many H3270 Host Links do you have?", below. 

• If you reply with a nonzero number, the program continues: 

VIP terminal number N 

• This message, and the seven prompts following it, appear 
N times, where N is the number you entered in response to 
the earlier question, "How many VIP's do you have?". 

What channel number will this device be on? 

• You must provide the Megabus channel number to which this 
device is attached. 

• You must enter exactly four hexadecimal characters, ending 
in '00' or '80'. 
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How many VIP's are polled on this channel? 

• ? is not acceptable here. 

• Acceptable answers are the numbers 0 through 31, 
inclusive. 

Enter the communications priority level for this terminal. 

• ? is not acceptable here. 

• Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 
levels (1 to 4) do you wish?". 

• If you specified only one communications priority level, 
this prompt won't appear. 

Enter the polling address for this VIP. 

• Acceptable answers are 0 through 31, inclusive. 

• This prompt appears only if you specified a non-zero value 
for the prompt "How many VIP's are polled on this 
channel?", above. 

Is this VIP a 'Control Station'? 


• ? is not acceptable here. 


• Acceptable answers 
Does this VIP have a ROP 

• Acceptable answers 


are YES, Y, NO, or N. 
(Receive-Only Printer)? 
are YES, Y, NO, or N. 


• If you reply NO, the program skips the next two prompts 
If you reply YES, the program continues: 

What type of ROP do you have? 

• There are eight supported ROPs: 


Specify One 


Devices Supported 
(See Appendix C) 


TN100 

TN300 (default) 

TN1200 

TTY33 

TTY35 


Te rmiNet 
TermiNet 
TermiNet 
ASR-33 
ASR-35 


100 or PRU 1001 
300 or PRU 1003 
1200 or PRU 1005 



V. 
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Does this ROP support form feed? 

• ? is not acceptable here. 

• Acceptable answers are YES, Y, NO, or N. 

How many H3270 Host Links do you have? 

• The program is now attempting to configure stations for 
the BSC 3270 line protocol handler in your configuration. 

• Acceptable answers are a nonzero number or NONE. 

• If you reply NONE, the program skips to the prompt, 

"How many PVE groups do you have?", below. 

• If you reply with a nonzero number, the program continues: 

H3270 line number N 

• This message, and the 4 prompts following it, appear N 
times, where N is the number you entered in response to 
the earlier question, "How many H3270 Host Links do you 
have?". 


What channel number will this line be on? 

• You must provide the Megabus channel number to which this 
line is attached. 

• You must enter exactly four hexadecimal characters, ending 
in '00' or '80'. 

Enter the communications priority level for this line. 

• ? is not acceptable here. 

• Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 
levels (1 to 4) do you wish?". 

• If you specified only one communications priority level, 
this prompt won't appear. 

Enter the polling address (decimal) for this H3270 Host Link. 

• ? is not acceptable here. 

• Acceptable answers range from 0 through 255, inclusive. 
M4_SYSDEF converts this number to a hexadecimal value 
for you when it defines the H3270 directive. 
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Enter the select address (decimal) for this H3270 Host Link. 

• ? is not acceptable here. 

• Acceptable answers range from 0 through 255, inclusive. 
M4_SYSDEF converts this number to a hexadecimal value 
for you when it defines the H3270 directive. 

How many PVE groups do you have? 

• The program is now attempting to build facilities for 
polled VIP emulated (PVE) groups into your configuration.’ 

• If you reply "NONE", the program skips to the prompt, 

"How many STD groups do you have?". 

• If you reply with a nonzero number, the program continues: 
PVE group number N 

• This message, and the four prompts following it, appear 

N times, where N is your response to the earlier question, 
"How many PVE groups do you have?". 

Enter channel number for PVE group N 

• ? is not acceptable here. 

• You must enter exactly four hexadecimal characters, ending 
in '00' or '80'. 

How many PVE stations are there on this channel? 

• ? is not acceptable here. 

• Acceptable answers are 1 through 32, inclusive. 

Enter the communications priority level for this group. 

• ? is not acceptable here. 

• Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 
levels (1 to 4) do you wish?". 

• If you specified only one communications priority level, 
this prompt won't appear. 


'A PVE group consists of all the PVE stations assigned to the 
same hardware channel. f 


4-18 


CB23-03 



Enter the polling address (0 to 31) for PVE station N 

• ? is not acceptable here. 

• Acceptable answers are 0 through 31, inclusive. 

• The prompt appears N times, where N is your response to 
the earlier question, "How many PVE groups do you have?". 

How many STD groups do you have? 

• The program is now attempting to configure all MLCP/DLCP 
connected synchronous terminal devices. 

• The following synchronous terminal devices are 

supported: VIP 7804, VIP 7805, VIP 7700, VIP 7700R, 

VIP 7705R, and VIP 7760. 

• If you reply NONE, the program skips to the prompt: 

"How many MLCP-connected Binary Synchronous Commun¬ 
ications (BSC) lines do you have?", below. 

• If you reply with a nonzero number, the program 
continues: 

STD group number N 

• This message, and the 8 prompts following it, appear 

N times, where N is your response to the earlier ques¬ 
tion, "How many STD groups do you have?". 

Enter channel number for STD group N 

• You must enter exactly four hexadecimal characters, 
ending in '00' or '80'. 

Enter the communications priority level for this group 

• Acceptable answers range from 1 through your response 
to the earlier question, "How many communications 
priority levels (1 to 4) do you wish?". 

• If you specified only one communications priority 
level, this prompt won't appear. 

How many STD stations are there on this channel? 

• The reply "?" is not acceptable here. 

• Acceptable answers are 1 through 32, inclusive. 
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Enter the polling address (0 to 31) for STD station N 

• ? is not acceptable here. 

• Acceptable answers are 0 through 31, inclusive. 

• The prompt appears N times, where N is your response 
to the earlier question, "How many STD groups do you 
have?" . 

What is the device type for this STD device? 

• You must specify one of the following device types: 

Device Type Supported Devices 

V7804 VIP 7804, VIP 7805 

V7700 VIP 7700, VIP 7700R, VIP 7705R 

V7760 VIP 7760 

Does this STD have a ROP (Receive-only printer)? 

• If you reply NO, the program skips the next prompt. 

If you reply YES, the program continues: 

What type of ROP do you have? 

• There are four supported ROPs: 

Specify One Devices Supported 

ROSY24 PRU 1003 

ROSY26 PRU 1005 

TN300 TermiNet 300 

TN1200 TermiNet 1200 

How many MLCP-connected Binary Synchronous Communications (BSC) 
lines do you have? 

• The program is now attempting to build facilities for BSC 
lines into your configuration. 

• ? is not acceptable here. 

• If you reply 0, the program skips to the prompt, "How 
many MDC-connected console devices do you have?", below. 

• If you reply with a nonzero number, the program continues: 
BSC line number N 

• This message, and the three prompts following it, appear 

N times, where N is your response to the earlier question, 
"How many MLCP-connected BSC lines do you have?". 
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What channel number will this device be on? 


• ? is not acceptable here. 

• You must enter exactly four hexadecimal characters, ending 
in '00' or ’80'. 

Enter the communications priority level for this terminal. 

• ? is not acceptable here. 

• Acceptable answers range from 1 through your response to 
the earlier question, "How many communications priority 
levels (1 to 4) do you wish?". 

• If you specified only one communications priority level, 
this prompt won't appear. 

Is this BSC line a 'Primary' one? 

• ? is not acceptable here. 

• Acceptable answers are YES, Y, NO, or N. 

How many MDC-connected console devices do you have? 

• The program is now attempting to build facilities for all 
MDC-connected terminal devices. 

• If you reply NONE, the program skips to the prompt, "How 
many diskettes do you have?", below. 

• If you reply with a nonzero number, the program continues: 

CON number 1 

What channel number will this device be on? 

• This prompt appears only if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many MDC-connected console 
devices do you have?". 

• You must enter exactly four hexadecimal characters, 
ending in '00' or '80'. 

What is the device type for the Operator's CONSOLE? 

• You must specify one device as the Operator's terminal: 
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Value 


Physical Device Type 


7200 

VIP 7200 (DKU9103) 

VIP 7205 (DKU9102) 


The value 7200 must be used if MDC- 
connected VIP 7200 terminals are to 
be used for forms processing using 
the Display Formatting and Control 
Facility. 

PRU 

PRU10 0 3/PRU100 5/TWU10 03/TWU100 5 

D7200 

VIP 7207 

KSR 

The terminal is to be supported in 
teleprinter mode. 

7801 

VIP 7801, VIP 7802 


CON number N 

• This message, and the two prompts following it, appear 
N - 1 times, where N is your response to the earlier 
question, "How many MDC-connected console devices do 
you have?". 

What channel number will this device be on? 

• You must enter exactly four hexadecimal characters, ending 
in '00' or '80'. 

• This prompt appears only if you are explicitly entering 
channel numbers. 

• ? is not acceptable here. 

What is the device type for this CON device? 

• Specify one of the values previously described for CON 
number 1. 


How many diskettes do you have? 

• The program is now attempting to build facilities for 
diskette devices into your configuration. (See Appendix 
C for a list of diskette device.) 

• If you reply 0, the program skips to the prompt,"How many 
cartridge disks to you have?", below. 

• If you reply with a nonzero number, the program continues: 
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Diskette number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many diskettes do you have?" 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

How many cartridge disks do you have? 

• The program is now attempting to build facilities for 
cartridge disk devices into your configuration. (See 
Appendix C for a list of cartridge disk devices.) 

• Your configuration must have at least one cartridge disk, 
cartridge module disk, or mass storage unit. 

• If you reply 0, the program skips to the prompt, "How 
many cartridge module disks do you have?", below. 

• If you reply with a nonzero number, the program continues 

Cartridge Disk number N 

• This message, and the two prompts following it, appear N 
times, where N is your response to the earlier question, 
"How many cartridge disks do you have?". 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

Does this Cartridge Disk have a fixed platter? 

• ? is not acceptable here. 

• Acceptable answers are YES, Y, NO, or N. 

How many cartridge module disks do you have? 

• The program is now attempting to build facilities for 
cartridge module disks into your configuration. (See 
Appendix C for a list of cartridge module disks.) 
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"How many 


• If you reply 0, the program skips to the prompt, 
storage modules do you have?", below. 

• If you reply with a nonzero number, the program continues: 

Cartridge Module Disk Number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many cartridge module disks do 
you have?". 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

How many storage modules do you have? 

• The program is now attempting to build facilities for mass 
storage devices into your configuration. (See Appendix C 
for a list of mass storage devices.) 

• If you reply NONE, the program skips to the prompt, "How 
many card reader/punches do you have?", below. 

• If you reply with a nonzero number, the program continues: 

Storage Module number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many storage modules do you 
have?" 

• ? is not acceptable here. 

• You must enter exactly four hexadecimal characters, ending 
in '00' or '80'. 


How many card readers do you have? 

• The program is now attempting to build facilities for card 
reader devices into your configuration. (See Appendix C 
for a list of card reader devices.) 

• If you reply 0, the program skips to the prompt, "How many 
card reader/punches or punches do you have?", below. 


V 
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• If you reply with a nonzero number, the program continues: 

Card reader number N 

What channel number will this device be on? 

• This prompt only appears if you- are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many card readers do you 
have?". 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

How many card reader/punches or punches do you have? 

• The program is now attempting to build facilities for card 
reader/punch devices or card punch devices into your con¬ 
figuration. Note that "card reader/punch" doesn't mean 
card readers or card punches, but devices that both read 
and punch cards. (See Appendix C for a list of card 
reader/punch devices.) 

• If you reply 0, the program skips to the prompt, "How many 
printers do you have?", below. 

• If you reply with a nonzero number, the program continues: 

Card reader/punch or punch number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• ? is not acceptable here. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many card reader/punches or 
punches do you have?". 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

How many printers do you have? 

• The program is now attempting to build facilities for 
line printer devices into your configuration. (See 
Appendix C for a list of line printer devices.) 

• If you reply 0, the program skips to the prompt, "How 
many 9-track magnetic tape devices do you have?", below. 
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• If you reply with a nonzero number, the program continues: 

Printer number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many printers do you have?". 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

How many 9-track magnetic tape devices do you have? 

• The program is now attempting to build facilities for 
9-track magnetic tape devices into your configuration. 

(See Appendix C for a list of 9-track magnetic tape 
dev ices.) 

• If you reply 0, the program skips to the prompt "do you 
wish to have ALL system overlays resident (yes or no)?", 
below. 

• If you reply with a nonzero number, the program continues: 

Magnetic Tape Device number N 

What channel number will this device be on? 

• This prompt only appears if you are explicitly entering 
channel numbers. 

• This prompt appears N times, where N is your response to 
the earlier question, "How many 9-track magnetic tape 
devices do you have?". 

• ? is not acceptable here. 

• You must supply exactly four hexadecimal characters, 
ending in '00' or '80'. 

Do you wish to have ALL system overlays resident? (yes or no) 

• Acceptable answers are YES, Y, NO, or N. 

• If you answer yes, the system optimizes the execution 
speed of all functions; the resulting system will occupy 
more memory than a system without resident overlays. The 
program skips to the prompt, "Do you wish to create a 
batch memory pool?" 

• If you answer no, the program continues: 
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Do you 

Do you 

Do you 

Do you 

Do you 

Do you 

Do you 

Do you 


How big 


wish to optimize the reading/writing of relative files? 

By making particular system input/output overlays perma¬ 
nently resident, you can obtain optimum speed for selected 
file types. This prompt, and the six that follow, ask if 
you wish to optimize the execution speed necessary to per¬ 
form different functions. 

Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of random files? 

Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of indexed files? 

Acceptable answers are YES, Y, NO, or N. 

wish to optimize relative files with deletable records? 
Acceptable answers are YES, Y, NO, or N. 

wish to optimize file management open/close functions? 

Acceptable answers are YES, Y, NO, or N. 

wish to optimize the reading/writing of tape files? 

Acceptable answers are YES, Y, NO, or N. 

This prompt appears only if you previously specified 
that your system supports magnetic tape devices. 

wish to optimize EBCDIC tape functions? 

Acceptable answers are YES, Y, NO, or N. 

wish to create a batch memory pool? 

Acceptable answers are YES, Y, NO, or N. 

If you answer no, the program skips to the prompt, "Enter 
the number (1 to 10) of 320-word system overlay areas you 
desire", below. If you answer yes, the program continues: 

a batch pool? (nnnnn or nnk words) 


• Nonnumeri.c characters (except for "k") are not acceptable 
here. 


• You must supply a numeric value of the form nnnnn or nnk 
words. 
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Enter the number (1 to 99) of system overlay areas you desire. 

• Nonnumeric characters are unacceptable here. 

• The number of system overlays that you specify will be 
loaded into the system area of memory where they will 
remain resident for the duration of the configured system. 
The larger the number of system overlays is, the more 
likely it is that frequently used system overlays will be 
found in memory. 

Would you like to see the generated statements? 

• Acceptable answers are YES, Y, NO, or N. 

• If you answer yes, M4_SYSDEF lists the contents of the 
file of CLM directives it has generated for you. At the 
top of the listing (below the SYS directive statement) the 
program identifies for you the version of M4__SYSDEF that 
you are using, as well as the date and time that your CLM 
directive file was generated. 

• If you spot an error at this point, you can enter rebuild 
mode by hitting the break key and then typing the command 
PI (program interrupt). See "M4_SYSDEF Dialog In Rebuild 
Mode" later in this section. 

• If you answer no, the program continues: 

Do you want to create a CLM directive file now? 

• Acceptable answers are YES, Y, NO, or N. 

• If you reply no to both this question and the preceding 
question, the program warns you that the directives will 
be lost and processing will terminate, and asks if this 
is what you intend. If you reply yes, this is what you 
intend, processing terminates, and no directive file is 
created. If you reply no, the previous question, "Would 
you like to see the generated statements?", is repeated. 

• If you reply no to this question but replied yes to the 
preceding question, processing terminates. 

• If you reply yes, the M4_SYSDEF program automatically 
generates a map file for you, containing configuration 
information you may find useful. (For a complete explana¬ 
tion of the map file, refer to the description of the 

MAP directive in Section 5.) The program assigns this 
map file the pathname >SID>CLM_MAP. If you wish to 
examine CLM_MAP after you create your CLM file, you can 
use a print (PR) command or invoke the Editor and use 
the Editor's read and print directives. 

• If you reply yes, the program continues: 
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Would you like to use a file name other than CLM_USER for this 
file? 

• Acceptable answers are YES, Y, NO, or N. 

• You may wish to use the default file name CLM_USER or a 
file name of your own. If you answer no, M4_SYSDEF cre¬ 
ates CLM_USER under your current working directory SID 
and processing terminates. 

> If this file already exists in your current working 

directory, M4_SYSDEF informs you and gives you the option 
of quitting, re-writting the file, or providing another 
file name. 

• Note that although you are free to rename your CLM file, 
the system must be able to locate a file named CLM_USER 
under directory SID at system startup. Renaming your CLM 
file allows you the option of creating more CLM files 
than just the one your system needs at configuration time. 
You may, for example, be creating CLM files for several 
installations, in which case you may want each one to have 
a unique name for identification purposes. 

• If you answer yes, the program continues: 

Enter your filename -- 

• The file name you choose must be no longer than 12-char¬ 
acters and must conform to standard file name conventions. 

• After you enter your file name, M4 SYSDEF creates your CLM 
file under your working directory SID, and processing 
terminates. The program lists the full pathnames of the 
CLM file and its corresponding restart file at your ter¬ 
minal. If, at some later time you wish to modify your CLM 
file, see "Using M4_SYSDEF in Rebuild Mode", earlier in 
this section. 

• If this file already exists in your current working 
directory, M4_SYSDEF informs you and gives you the option 
of quitting, re-writting the file, or providing another 
file name. 

M4-SYSDEF DIALOG IN REBUILD MODE 

Once you invoke M4 SYSDEF and specify the pathname of a 
restart file, the program responds with: You have entered 
M4 SYSDEF in the rebuild mode. Do you want to see the existing 
CLM statements? 

• If you respond YES, the program lists the CLM directives 
contained in your restart file. 

• If you respond NO, the program continues: 
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Do you wish to modify devices or system parameters? 

Respond with "SYSTEM", "DEVICES", "VIEW", or "DONE". 

Response = 

• Depending on your response, the program will enter 
the M4_SYSDEF dialog at the appropriate place so 

you can make modifications. Table 4-1 lists each ques¬ 
tion and response in the rebuild mode dialog. The com¬ 
plete M4_SYSDEF dialog is described earlier in this 
section. 

• If you respond SYSTEM, the program asks the question, 

"Do you wish to modify the prompt (PROMPT), memory 
size (MEMORY), the number of interactive users (USERS), 
the automatic generation of SPD names (SPD), the auto¬ 
matic channel assignment (CHANNEL), the record locking 
feature (RLOCK), the system overlay areas (SOAT), the 
resident overlays (RESOLA), the display formatting feature 
(VDAM), the commercial or SIP simulators (SIMUL), or the 
system and installation identification (IDENT)? Depending 
on your response to this question, the program will enter 
the M4_SYSDEF dialog at the appropriate place so you can 
make modifications. Once you have finished making your 
modifications, enter the reply DONE. 

• If you respond DEVICES, the program asks the question, 
"Respond with the device type or class that you wish to 
modify. "COMM", "CON", "DSK", "RCD", "MSM", "CMD", "CDR", 
"CRP", "LPT", "MTP", or "DONE". Depending on your 
response to this question, the program will enter the 
M4_SYSDEF dialog at the appropriate place so you can make 
modifications. If you reply DONE, the program will repeat 
the prompt, "Do you wish to modify devices or system 
parameters?" When you have finished making your modifi¬ 
cations, enter the reply DONE. 

• If you reply VIEW, the program lists the current CLM 
file at your terminal. 

• If you reply DONE, the program skips through the M4_SYSDEF 
dialog to the prompt, "Would you like to see the generated 
statements?" Normal M4_SYSDEF termination prompts follow. 

• When M4_SYSDEF processing terminates normally, the program 
will list the pathnames of your CLM directive file and 
its associated restart file. If you wish to modify this 
CLM file at some later time, you invoke M4_SYSDEF, 
specifying the pathname of this restart file on the com¬ 
mand line. 
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Table 4-1 lists each question and response in the rebuild 
mode dialog. Using this table, you can trace each of your 
possible responses to a specific entry point in the M4_SYSDEF 
program dialog. 

To use this table, begin in the left hand column and read 
across to the right. Note that the questions you are required 
to answer become more specific as you isolate the specific 
section of the M4_SYSDEF dialog that you wish to enter. The 
fifth column lists the actual questions in the M4 SYSDEF program 
dialog that appear as a result of your responses Eo previous 
rebuild mode questions. Column six lists the pages in this 
section of the manual that explain each M4_SYSDEF question in 
detail. ~~ 
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Table 4-1 Rebuild Mode Dialog 


Rebuild Mode Dialog 

M4_SYSDEF Dialog 

Question 

Response 

Question 

Response 

Prompt 

Page 

Reference 

Do you wish to modify devices 

SYSTEM 

Do you wish to modify the prompt (PROMPT), 
memory size (MEMORY), the number of inter¬ 
active users (USERS), the automatic gen¬ 
eration of SPD names (SPD), the automatic 
channel assignment (CHANNEL), the record 
locking feature (RLOCK), the system over¬ 
lay areas (SOAT), the resident overlays 
(RESOLA), the display formatting feature 
(VDAM) , the commercial or SIP simulators 
(SIMUL), or the system and installation 
identification (1DENT)? 

PROMPT 

Do you wish to use the long prompt mode? 

4-8 

with "SYS'lEM", "DEVICES" , 

"VIEW, or "DONE". 


MEMORY 

What is the total amount (in words) of 
real memory on the machine this system 
is to run on? Ehter the value in the 
form: nnnk. 

4-8 



USERS 

Please enter the maximum number of con¬ 
current users that you expect this sys¬ 
tem to support. 

4-12 



SPD 

Snould I automatically generate the SPD 
names for you? 

4-12 




CHANNEL 

Do you wish the system to supply the 
channel numbers for noncommunications 
devices? 

4-9 




RLOCK 

Do you wish this system to activate the. 
Record Locking Feature of Data Manage¬ 
ment? 

4-12 




SOAT 

Enter the number of system overlay areas 
you desire. 
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RESOLA 

Do you wish to have all system overlays 
resident? 

4-26 




VDAM 

Do you wish’to include Display Formatt¬ 
ing and Control Software? i 

i 

4-13 




SIMUL 

Is this a commercial system? 

Reply "YES" or "NO". 

4-10 




IDENT 

The default system identification is 
'GCOS6/MOD400 1 . If you wish to change 
it, reply ’YES*; if you do not wish to 
change it, reply ’NO’. Do you? 

4-11 


DEVICES 

Respond with the device type or class that 
you wish to modify. "COMM", "CON", "DSK" 

"RCD", "MSM", "CMD", "CDR", "CRP", "LPT", 
"MTP", or "DONE". 

COMM 

Do you wish to modify the communications 
levels and the number of MLCP's (COMM) 

(see note), the vip's (VIP), the Host 
Links 8H3270), the pve's (PVE), the syn¬ 
chronous terminals (SID), the asynchron¬ 
ous terminals (AID), or the bsc's (BSC)? 

NOTE: Type COMM to enter the dialog at 
the question "Does this system have any 
communications type devices?" Then type 
VIP, H3270, PVE, STD, ATD, or BSC to 
enter the dialog at a more specific 
point. 

COMM,4-13 
VIP,4-15 
H3270,4-17 
PVE,4-18 
STD,4-19 
ATD,4-14 

BSC,4-20 
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Do you wish to modify devices 
or system parameters? Respond 
with "SYSTEM", "DEVICES", "VIEW", 
or "DONE". 


CON 

How many MDC-connected console devices 
do you have? 

DSK 

How many diskettes do you have? 

RCD 

How many cartridge disks do you have? 

MSM 

Haw many storage modules do you have? 

CMD 

How many cartridge module disks do you 
have? 

CDR 

how many card readers do you have? 

CRP 

How many card reader/punches or punches 
do you have? 

LPT 

How many printers do you have? 

MTP 

How many 9-track magnetic tape devices 
do you have? 

DONE 

Do you wish to modify devices or system 
parameters? Respond with "SYSTEM", 
"DEVICES", "VIEW", or "DONE". 



(No question is asked. This response 
causes tne current C'LM directive file to 
be listed at your terminal.) 

Would you like to see the generated 
statements? 









EXAMPLES OF M4.SYSDEF USAGE 


The following examples illustrate how you can first create a 
CLM directive file and then modify it at some later time by 
invoking M4_SYSDEF in rebuild mode. Example 1 steps through the 
entire M4_SYSDEF dialog. Example 2 illustrates the rebuild mode 
dialog. 

Example 1: 

Following a Stage 1 (initial) system startup, a new user 
wishes to create a CLM file using M4_SYSDEF. Prior to 
invoking M4_SYSDEF, the user must transfer control of the 
operator's terminal from the $S (system) task group to the 
supplied user task group $H: 

ACA:$H: 

The terminal is now under control of the $H task group. The 
user wishes to see the ready prompt message, and so enters 
the RDN (ready on) command: 


RDN 


The system responds: 

($H)RDY: 

The user invokes M4 SYSDEF and defines a CLM file: 
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M4_SYS0fcF 

HELLO 1 THIS TOOL WILL HELP YOU GENERATE THE FILE CONTAINING 
THE CONFIGURATION LOAD MANAGER DIRECTIVES (THE CLM.USER FILE). 

WHICH IS NECESSARY TO HURD YOUR GCOSfe/MOD«00 OPERATING SYSTEM. 

00 YOU WISH TO USE THE LONG PROMPI MODE? 

-> 

THERE are TWO mooes IN WHICH T.U RUN THIS TOOL# THE LUNG 

MODE AND THE SHORT MUDE. IF YOU PICK THE LONG MODE, EVERY PHUMPT 

MESSAGE WILL HE PRECEDED BY AN EXPLANATION OF WHAT (HE REQUESTED 

INFORMATION IS, WHERE YOU CAN FIND THE REQUESTED INFORMATION, AND 

WHAT WILL HAPPEN IF YOU SUPPLY CERTAIN INFORMATION. THE SHORT MODE SHOULD 

8E USED BY PERSONS WHO HAVE BUILT THIS SYSTEM BtFURt AND DO NOT NtED 

THE LONG PROMPT TtXT. IF YQU SELtCT THE SHORT MODE AND THEN RIND 

THAT YOU NEED HELP IN ANSWERING ONE OF THE QUESTIONS, YOU CAN OBTAIN 

THE LONG MUl)E TExI riY ENTERING A '?'; THIS WILL NOT CHANGE THE MUUt 

AMD ALL SUBSEQUENT QUESTIONS WlLL'BE OF THE SHURT FORM, 

SINCE THIS IS A GENERALIZED TOOL, CERTAIN COMMON DEFAULTS HAVE BEEN 
ASSUMED; IF YOUR SYSTEM REQUIRES A CHANGE TU THESE UtFAULTS, YUU CAN 
GENERATE the ’CLM.USER’ file and I hen USE the STANDARD EDITOR 
TO MAKE THESt MODIFICATIONS, GOOD LUCK, 

DO Y(JU WISH TU USt THE LONG PRUMPI MODE? 

YES 

THE TUTAL AMOUNT UF HEAL, PHYSICAL MEMORY INSTALLED UN THE MACHINt 
FUR WHICH THIS SYSTEM IS BEING BUILT MAY BE DIFFERENT FHUM 
THE MEMORY AVAILABLE UN THE MACHINE YOU are CURRENTLY USING. 

THE MINIMUM CONFIGURATION FOR GCOSfe/MQUUOO IS ' 46K' WORDS. 

WHAT IS T H t TOTAL AMuUNT (IN WORDS) OF REAL M E M U R Y UN THE MACHINt THIS 
SYSTEM IS Tu RIJN UN? ENTER THE VAlUE IN THE FORM! NNNK . 

128K 

IF YOU WISH, WE CAN GENERATE ThE CLM DIRECTIVES WlIHUUT SPECIFYING 
THE CHANNEL NUMBERS FUR NON-CUMMUNICATIUN TYPE DtVlLES. FOR 
COMMUNICATION DEVICES YOU MijST ALWAYS PROVIDE A CHANNEL NUMBER. 

AT SYSTEM START-UP TIME, THE SYSTtM WILL POLL THE HARUWARt AND 
DETERMINE UPON WHICH CHANNEL EACH DEVICE IS LOCATED. 

00 YOU WISH THE SYSIEm TU SUPPLY I HE CHANNEL NUMBERS FUR 
NUN-COMMUNICATION OfcVICES? 

NO 


ENTER THE CHANNEL NUMBER UF THE UPERATOR TERMINAL 
WHICH will BE THE CONSOLE 

oaoo 

ENTER THt CHANNEL NUMBER UF THE BOOT DEVICE 

1«00 

DO YUU WISH TO BUUT THE FIXED PLAITE«? 

NO 


Figure 4-1. Using M4_SYSDEF 
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A COMMERCIAL SYSTEM IS A MODEL 4/ OR MODEL S7. ^ 

IS THIS A CUMMERCIAL SYSTEM? REPLY "YES" OR "NO.” 

N V 

SINCE YOU DU NOT HAVE A COMMERCIAL SYSTEM, WILL YOU 
HAVE THE COMMERCIAL SIMULATOR; IF YOU REPLY 'NO', THtN 
THIS SYSTEM HILL NOT BE ABLE TO SUPPORT COBOL. 

WILL THIS SYSTEM HAVE A COMMERCIAL SIMULATOR? 

Y 


SIP MEANS'SCIENTIFIC INSTRUCTION PROCESSOR'. 

WILL THIS SYSTEM HAVE A SIP? REPLY "YES" OR "NO." 

N 

SINCE YOU DO NOT HAVE THE 'SCIENTIFIC INSTRUCTION PRUCESSUR', WILL YOU 
HAVE THE SIMULATOR FOR THIS HARDWARE OPTION? IF YOU REPLY ' NU' , I HE N 
THIS SYSTEM WILL NOT BE ABLE TO SUPPORT ANY OF THE SCIENTIFIC 
INSTRUCTIONS. 

WILL THIS SYSTEM HAVE A SIMULATOR FOR THE SIP? REPLY "YES" UR "NO," 

YES 

00 YOU WANT THE DOUBLE PRECISION SIMULATOR SIPSIM? 

NO 

THE SYSTEM IDENTIFICATION IS ONE OF THE STANDARD PARTS OF THE CUMMENT 
STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES. 

IF YOU ENTER A NEW VALUE MAKE SURt IT IS ENCLOSED WITHIN 
APOSTROPHE MARKS UR SOME OF THE INFQRMAIIUN MAY BE LUST. 

THE DEFAULT S Y S T t M IDENTIFICATION IS 'GCOS6/MOU400 ' . 

IF YOU WISH TO CHANGE IT, REPLY 'YES'; IF YOU UU NU I W'lSH TO 
CHANGE IT, REPLY 'NO'. UU YOU? 

Y 

ENTER THE NEW SYSTEM IDENTIFICATION ( 3 0 CHARACTERS UK LtSS) IN THt FuKMj 
'SYSTEM^IDENTIFICATION' 

'GC0S6/MUD «00 VERSION 2.1' 

THE INSTALLATION IDENTIFICATION IS ONE OF THE STANDARD PARIS UF THt 
COMMENT STATEMENTS THIS UTILITY AUTOMATICALLY GENERATES. 

IF YOU ENTER A NEw VALUE, MAKE SURE IT IS ENCLOSED 

WITHIN APUSTRUPHr. MARKS OR SOME OF THE INFORMATION MAY bE LUS1. 

THE DEFAULT INSTALLATION IDENTIFICATION IS 'YfjuR TOWN, USA*. 

IF YOU WISH TO CHANGE IT, REPLY 'YES'; IF YOU luj NU I WISH 10 
CHANGE IT, REPLY 'NO'. DO YOU? 

YES 

ENTER THE NEW INSTALLATION IDENTIFICATION (SO CHARACTERS UK LtSS) 

IN THE FORM! 'INSTALLATION ID' 

'TEST SITE ONE' 

THE NUMBER OF CONCURRENT USERS ASSISTS IN THE CALCULATION OF SYSTEM 
STRUCTURE SUES AND MEMORY NEEDS WHICH VARY UfcPtNDlNG 
UPON THE MAXIMUM LOAD THt SYSTEM IS TO BE CUNFIGURtU 
FOR. THtRE IS, HUwtVER, NO WAY TU ENSURE THAT ThE MAXIMUM 
NUMBER OF USERS THAT YOU SPECIFY HERE WILL INDEED 


Figure 4-1 (cont). Using M4 SYSDEF 


V 
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BE THfc MAX. NUMBtR OF USERS THE SYSTEM wlLL SUPPORT. THIS DEPENDS 
ON SUC M DYNAMIC VARIABLES AS THE .YORK EACH USER IS PtH FORMING# AND 

memory fragment a r iun. 

PLEASE ENTER THE MAXIMUM NUMBER OF CONCURRENT USERS THAT YOU 
EXPECT THIS SYSTEM TO SUPPORT. 
b 


EVERY PERIHHERAL DEVICE ATTACHED Tij THIS SYSTEM MUST hAVt A 
SPD (SYMBOLIC PERIPHERAL DEVICE) NAME. THIS NAME IS A 
UNIQUE b CHA*ACTtR (MAXIMUM) NAME WHICH CONFORMS TO THE FILE SYSTtM 
NAMING CONVENTIONS. IE YOU REPLY 'YES' HERE, i WILL GENEKATt THESE 
NAMES FOR YOU WITHOUT ANY FURTHER PROMPTS. IF YUU R t PL Y 'NO'# I WILL 
ASK YOU TU SUPPLY T hE SPD NAME FOR EACH ANO EVERY UEVICE AS Wt 
CONFIGURE THAT Dt V ICE 

SHOULD ( AUTOMATICALLY GENERATE TnE SPD NAMES FUR YUU? 

Y 


RECORD LOCKING IS THE FINEST GRANULARITY OF CUNCURRENCY CUNTROL THAT 
DATA MANAGEMENT PROVIDES. ACTIVATION OF THIS KUN-TIMt OPTION PROVIDES 
TOOLS TO ALLOW more ThAN ONE USER Tg /(RITE RECORDS TU A GIVEN FILt AT 
THE SAME TIME. PROPER USAGE OF THIS OPTION INSURES THAT ALL UPDATtS 
ARE CORRECTLY A = PLItO TO THE FILE. IF YOU REPLY "YES' 1 , THIS OPTION WILL 
BE AVAILABLE. I - YUU kEPLY "NU", IHEN DATA MANAGtMtNT WILL tNFURLt 
FILE LtvEL CONCURRENCY # I.E. ONLY UNE USER WITH WRITE PERMISSION TO A FILt. 
DO YOU WISH THIS SYSTEM TU ACTIVAIE THE RECORD LUCKING FEATURE OF 
DATA MANAGE mENT? 

YES 

IF YOU ARt PLANNING TU USE T Ht DISPLAY FURMATTING AND CONTROL 
SOFTWARE we NEED TU KNOW SO IT C A x BE INCLUDED In THE SYSTEM, 

DO YOU WISH Tij INCLUDE DISPLAY FORMATTING AND CUNTROL SOFTWARE? 

YES 

DO YOU WISH Tu ACTIVATE THE POWER FAIL RESTART? 

YES 

DOES THIS SYSTEM HAVE ANY COMMUNICATIONS TYPE UtVlLtS? 

I.E., VIPS, TTYS, t T C . 

YES 

EVERY DtVlCE MUST BE ASSIGNED TO A HARDWARE INTERRUPT LtVEL. 
wE WILL PICK The ABSOLUTE VALUE FuR ALL DEVICES, SINCt THEY MUST 
(WITH ONE EXCtPTIUN) BE UNIQUE. CUMMUNICATIUNS UtVlCtS, HUwtVtK, 

MAY SHARE HARDWARE LtVELS AND THUS TO FACILITATE Tht ASSIGNMENT 

you must provide: a relative LtvEL fur each communication utvicE 

CONFIGURED. The ANSWER TU THE NtXT QUESTION WILL 

SET UP THE RANGE OF LEVELS YOU wloH TO HAVE. THE ACCEPTABLE VALUtS 
ARt? l,2,3,4. IE YUU SPECIFY 1, I H£N ALL COMMUNICATION DtVICES 
WILL BE ON THE SAME HARDWARE LEVEL. IF YOU SPtCIFY 3, IHtN YUU 
WILL HAVt THE OPPORTUNITY T0 SPREAD THE COMMUNICATION DEVICES 
OVER 3 StPARATt LtVtLS (1, 2, 3), WITH THUSt OtVlCtS ON LtVEL 


Figure 4-1 (cont). Using M4_SYSDEF 
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1 HAVING THfc HIGHEST PRIORITY AND THQBE ON LEVEL 3 1 Ht LOWEST. 
HOW MANY COMMUNICATION PRIURITY LEVELS (1 TU 4) DU YUU WISH? 
ENTER THE NUMBER UF LEVELS, 
a 

ALL COMMUNICATION TYPE DEVICES MUST BE ATTACHED TU A MULTI-LINE 
COMMUNICATIUNS PRUCESSOR (MLCP). 

HOW MANY MLCPS (1 TU 10) WILL THIS SYSTEM HAVE' 

a 


WE ARE READY TO CONFIGURE ANY MLCP CONNECTED ASYNCHnUNUUS TERMINAL 
DEVICES (ATO) THAT YOU HAvE. THESt INCLUDE THE 7 2 00 RUN IN TELEPRINTER 
MODE AND ALL OTHER ATDS. IF YOU OU NOT HAVE ANT OF THESE DEVICES TU 
CONFIGURE REPLY "NONE” TO THE FOLLOWING UOESTIUN. 

HOW MANY ATDS DO YOU HAVE? 

2 


A T D TERMINAL NUMBER 1 

YOU NEED TO PROVIDE THE BUS CHANNtL NUMBER TO which THIS DEVICE 
HAS SEEN ATTACHED. THE CHANNEL NUMBER IS A UNIQUE FUUR CHARACTER 
HEXADECIMAL VALUE WHICH ENDS WITH EITHER "00" UR "BO" , 

YOU MUST EnTER EXACTLY four characters. 

•WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

FD80 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FUR THIS TERMINAL 

2 

DEVICE types supported by the asynchronous TERMINAL device driver include 
TTY, 7200, 7801, 0/200 AND PRU. 

WHAT IS THE DEVICE TYPE FOR THIS ATQ DEVICE? 

TTY 

A TD TERMINAL NUMBER 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

FCOO 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FOR THIS TtRMINAL 
3 

WHAT IS THE OEVICt TYPE FUR THIS ATD DEVICE? 

780 1 


WE ARE NOW READY TU CONFIGURE THE VIP77U0S OR VIP7B0US WHICH 
ARE TO BE RUN IN VIP7700 EMULATION MODE. IF YOU DO NUT HAVE ANT 
VIPS TO CONFIGURE. RtPLY 'NONE' TU THE F OLLUwING QUESTION. 

HOW MANY VIPS DO YUU HAVE? 

3 


VIP TERMINAL NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 
FF 00 

HOW MANY VIPS ARE POLLED ON THIS CHANNEL? 

0 


Figure 4-1 (cont). Using M4_SYSDEF 

i 


/f" 
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ENTER THt COMMUNICATIONS PRIORITY LEVEL FOR THIS TERMINAL 

p 

IS THIS VIP A 'CLmMTkUL STATION'? 

YES 

DOES THIS VIP HAVE A PUP (RECtlVE ONLY PRINTER) ? 

YES 

THERE Akf b TYPES OF RUP: TTY33, l-T Y 3S * TN100, TN300* AND TNIPOO. 

WHAT TYPE OF RUP DU YIJU HAVE? 

TNIPOO 

DOES THIS KUP SUPPORT FORM FEED? 

YES 

VIP TERMINAL NuMHtR P 

what channel number will this device be on? 

FF80 

HOW MANY VIPS Akt PULLED ON THIS LHANNEL? 

NONE 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FOR THIS TtRMlNAL 
3 

IS THIS VIP A ' CUNT Kill STATION'? 

N 

DOES THIS VIP HAVE A RUP (RECEIVE ONLY PRINTER) ? 


VIP TtRMl'VAL NUFBEk 3 
.-.HAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

F E 0 0 

HQw MAhY VIPS ARE POLLED ON THIS CHANNEL? 

1 

ENTER T h t CUMMUNICAT TUNS PRIORITY LEVEL FUR THIS TERMINAL 
P 

ENTER T h t PuLLI n b ADDRESS FOR THls vlP 
TP 

DOES This vIP have A ROP (RECEIVE ONLY PRINTER)? 

NO 


WE ARE NOw RfcADY TO CUNFIGOHE THE Hi?70 HOST LINKS WHICH ARt TO 
HE Pun by TMfc BSC LINE PROTOCOL HANDLER. IF YUU DU NUT HAVE ANY 
h 3 P 7 0 HOST LINKS 10 CONFIGURE* REPLY NONE TU The FULLUWING UUESTIUN. 
H0W M A u Y H3P70 HOST LINKS DO YOU HAVE? 

P 

H 3 P 7 0 Llut NUMBER 1 

WHAT CHANNEL NUMBER WILL THIS LINt BE UN? 

7 

YOU NEED Tu PROVIDE ThE BUS CHANNtL NUMBER TO WHICH THIS DEVICE 
HAS BEEN ATTACHED. The CHANNEL NUMBER IS A UNIQUE FUUK CHARACTER 
HEXADECIMAL VALUE WHICH lNDS WITH EITHER "00" UR "BO". 

YOU MUSI F.iMlEK EXACTLY FOUR CHARACTERS. 


Figure 4-1 (cont). Using M4_SYSDEF 
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WHAT CHANNEL NUMetR WILL THIS LINt BE UN? N 

F880 

ENTER T Hfc COMMUNICATIONS PRIORITY LEVtL FOR THIS LINE V P 

2 

ENTER THE PULLING ADDRESS (DECIMAL) FUR THIS H3270 hUST LINK 

123 

ENTER THE SELECT ADDRESS (DECIMAL) FOR THIS H327U HUST LINK 

23a 

H 32 7 0 LINE NUMBER 2 
WHAT CHANNEL NUMbER MLL THIS LINE BE ON? 

F 8 0 0 

ENTER THE COMMUNICATIONS PRIORITY LEVEL FUR THIS LINE 

2 

ENTER THE POLLING ADDRESS (DECIMAL) FOR THIS H327Q husT LINK 

12 a 

ENTER THE StLECT ADDRESS (DECIMAL) FOR THIS HidIO HUST LINK 
235 


wE are NUa READY 10 CONFIGURE The POLLED VIP E -HJL A1 uR (Pvt) &RUUPS 
(A PVE GROUP CONSISTS OF ALL THE PVE STaTIunS ASSIGNED TO lht SAME 
HARDWARE CHANNEL). IF YOU DO NUT HAVE ANY PVE SI ATIUNS TO CUNUGURr., 
REPLY "NONE" 10 THE FOLLOWING QUESTIUN. 

HOA MANY PVE GROUPS DO YOU HAVE? 

2 


PVE GROUP NUMBER 1 
ENTER C h A NNt L MIM&tR FOR PVE GROUP J 
F 9 0 0 

HOW MANY PVE STATIUNS Are THERE OV THIS CHANNEL? 

2 

ENTER The COMMUNICATIONS PRIORITY LEVEL FUR THIS urOuh 

2 

ENTER THE PULLING ADDRESS (0 TO 31) FUR PVE STATION 1 

1 

ENTER THE PULLING ADDRESS (0 TO 31) FOR PVE STATION d 

2 

PVF GROUP NUMBER 2 

enter channel number for pve gruup a 

F 98 0 

HOW MANY Pvt STATIONS ARt THERE ON THIS CHANNtL ? 

3 


ENTER 

1 

ENTER 

1 

ENTER 

T Hfc 

CUMMUNICAT I ON S 

PRIUKITY LEVEL 

FUN 

IhlS b hU uP 

T H t 

POLLING ADDRESS 

(0 

TU 

31) 

FUN 

PVE 

ST A 1 1U(m 

T Hfc 

PULIINh ADDRESS 

(0 

TU 

31 ) 

F UN 

PVE 

S T A r 11)I\ 


2 
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ENTER TmE POLLING ADDRESS (0 TU 3 1) FOR PVE STATION b 
3 


wE ARE NOW ready IU CONFIGURE THE SYNCHRONOUS TtRMINAL DEVICt (STD) 
GROUPS (A STD GROUP CUNSISTS UF AlL THE STQ STATIUNS ASSIGNED TU THt 
SAME HARDWARE CHANNEL)* THE PULLING SEQUENCE WITHIN A GKUUP IS 

determined hy thc order entered. 

IE YOU DO not HAVE ANY STD STATIONS TO LUNFIGURE, 

REPLY "NONE" TO THE EULLOwlNG QUESTION, 

HOW MANY STD GROUPS DU YOU HAVE? 

a 


STD GROUP NUMBER 1 
ENTER CHANNEL NUMBER FUR STD GROUP 1 
F680 

ENTER ThE CUMMIJNIC A 1 IONS PRIORITY LEVEL FOR THIS GRUUP 
5 

HOW MANY STD STAIIONS ARE THERE 0 x THIS CHANNtL? 

2 

ENTER THE PULLING ADDRESS CO TO 31) FUR STD STATION 1 
23 

DEVICE TYPE'S SUPPORTED BY THE SYNCHRONOUS TERMINAL UtVICE DRlVtR 

INCLUDE V7804, V7/V0 AND V7780 

WHAT IS The DEVICt type F Ok THIS S T D DEVICE? 

V780a 

DOES THIS STD HAVE A KUP (RECEIVE OiyLY PhINTEP)? 

YES 

THERE ARE a types of pop: ROSvpa, RijSY2b, TN30O, and TN12U0. 

WHAT TYPE OF POP DO YOU HAVE? 

TN300 

ENTFR The POLLING ADDRESS (0 TU 31) FOR STD STATION 2 
2 a 

WHAT IS THE DEVICE TYPE FOR THIS STq DEVICE? 

V 7 8 0 a 

DUES TmIS STD HAVE A ROP (RECEIVE OnLY PRINTER)? 

Y 

WHAT TYPE OF ROP DO YOU HAVE? 

TN300 

STD GROUP NUM6E* 2 
ENTER CHANNEL NIimbEh Fop STD GROUP 2 
F b 0 0 

ENTER THE COMMUNICATIONS PRIORITY LEVEL for This GRUUP 
a 

HOW MANY STD STATIUNS ARE THERE On THIS CHANNEL? 

3 

ENTER THE PULLING ADDRESS (0 TO 31) EUR STD STATION 3 
23 

WHAT IS The DEVICE TYPE F Op THIS a To DEVICE? 
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V7700 

DOES THIS STD HAVE A ROP (RECEIVE UNLY PRINTER) ? 

YES 

WHAT type of rop do you have? 

TN1200 

ENTER THE PULLING- ADDRESS CO TU 31) FOR STD STATION 4 

24 

WHAT IS THE DEVICt TYPE F QR THIS STD DEVICE? 

V7700 

DOES THIS STD HAVE A RUP (RECEIVE ONLY PRINTER)? 

NO 

ENTER THE PULLING ADDRESS (0 TU 31) FOR STO STATION 5 

25 

WHAT IS THE DEVICE TYPE FOR THIS STD DEVICE? 

V77 00 

DOES THIS STD HAVE A RUP (RECEIVE UNLY PRINTER)? 

YES 

WHAT TYPE OF ROP DU YOU HAVE? 

TN1200 


HOW MANY MLCP CONNECTED BINARY SYNCHRONOUS COMMUNICATIONS (BSC) LINES 
DO YOU HAVt i 
2 


BSC LINE NUMBER 1 

WHAT CHANNEL NUMBER WILL THIS DEVICE be UN? 

FOOO 

ENTER The COMMUNICATIONS PRIORITY LEVEL FUR IH1S TEkMJuAl 

1 

IS THIS BSC LINE A 'PRIMARY' ONE? 

YES 

BSC LINE NUMBER 2 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

F 080 

ENTER THt COMMUNICATIONS PRIORITY LEVEL FUR IHIS TERMINAL 

1 

IS THIS BSC LINE A 'PRIMARY''UNE? 

NO 


WE ARE NUw READY TU CunFI SURE ALL MQC CuNNECTED CUNSULE UtVIUtS. 
THESE CUNSOLt DEVICtS ARE ALL HANDLED BY The CUNSULt DEVICE 
DRIVER ICON). IF YUU DU NOT HAVE ANY TU CONFIGURE, REPLY 
"NONE" TO THE FOLLOWING QUESTION. 

HOW MANY MQC CONNECTED CONSOLE DEVICES DU YUU HAVE? 

2 


CON NUMBER 1 


Figure 4-1 (cont). Using M4_SYSDEF 




4-42 


CB23-03 


WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

0400 

DEVICE TYPES SUPPORTED 8Y THE CONaULE DEVICE DRIVER INCLUDE 
KSR, 7(200, 7601, 07200 AND PRU. 

WHAT IS THE OfcVICt TYPE FOR THE OPERATOR'S CONSOLE? 

KSR 

CON NUMBER 2 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

0480 

WHAT IS THE DEVICE TYPE FOR THIS CON DEVICE? 

7801 

WE ARE NOW READY Tu CONFIGURE ALL*DlSKETTE DEVICES. IF 
YOU DO NOT HAVE ANY DISKETTE DEVICES, REPLY 'NONE' TO THE 
FOLLOWING QUESTION. 

HOW MANY DISKETTES DU YOU HAVE? 

4 


DISKETTE NUMBER 1 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 
0500 


DISKETTE NUMBER 2 

WHAT CHANNEL NUMBER WILL THI V S DEVICE BE ON? 
0580 


DISKETTE NUMBER 5 

WHAT CHANNEL NUMBER WILL THIS DEVICE HE UN? 

1200 

DISKETTE NUMBER 4 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 
1280 


WE ARE NOW READY TO CONFIGURE ALL CARTRIDGE DISK 
DEVICES. IF YOU DU NOT HAvE ANY Tu CONFIGURE, REPLY 'NUNE' TO THE 
FOLLOWING UUESTIUN. 

HOW MANY CARTRIDGE DISKS DU YOU HAVE? 

2 

.CARTRIDGE DISK NUMBER 1 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 

1400 

DOES This CARTRIDGE disk HAVE A FIXED PLATTER? 

YES 

CARTRIDGE DISK NUMBER 2 

WHAT CHANNEL NUMoER WILL THIS DEVICE BE UN? 

1480 


Figure 4-1 (cont). Using M4 SYSDEF 
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DOES THIS CARTRIDGE DISK HAVE A FIXED FLATTERY 

NO 


WE ARE NOw READY TO CONFIGURE ALL CARTRIDGE MODULE DISK 
OEVICES. IF YOU DU NOT HAVE ANY Tu CONFIGURE/ REFLY 'NONE' TO THE 
FOLLOWING QUESTION. 

HOW MANY CARTRIDGE MODULE DISKS DU YOU HAVE? 

2 


CARTRIDGE MODULE DISK NUMBER 1 
WHAT CHANNEL NUMhER will THIS DEVICE BE ON? 

1500 

•CARTRIDGE MODULE DISK NUMBER 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE bE UN? 

1580 

WE ARE NUw READY TU CONFIGURE ALL STORAGE MODULt 
DEVICES. IF YOU DU NUT HAVE ANY TU CONFIGURE/ RtFLY 'NONE' tu THE 
FOLLOWING GUESTIUN. 

HO^t MAnY STURAGE MODULES DO YOU HAVE? 

2 

STORAGE MODULE NUMBER 1 

WHAT CHANNEL NUMHtR WILL THIS DEVICE BE ON? 

1800 

STORAGE MODULE NUMBER 2 

WHAT CHANNEL NUMBER WILL THIS DEVICE BE ON? 

1880 

WE ARE NUW READY TO CONFIGURE CARD READER DEVICES. IF YOU 
DO NOT HAVE ANY TU CONFIGURE# REFLY 'NONE ' TU THE FOLLOWING UUESTION. 
HOW MANY CARD REAUERS DO YUU HAVE? 

2 

CARD READER NUMBER 1 
WHAT CHANNEL NUMBER WILL THIS DtVlCE BE ON? 

2200 

CARD READER NUMHtR 2 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 

YES 

INVALID CHANNEL NUMBERS MUST BE tXACTLY a CHARACTERS LUNol 
WHAT CHANNEL NUMBER WILL THIS DEVICE BE UN? 

2280 

WE ARE NUW RtADY TU CONFIGURE CARD PUNCH AND RtAUtK/PUNCH DEVICES. 
NOTE THAT THIS IS EITHER A CARD RtAQE'R/PUNCH OR A CARD PUNCH. 


Figure 4-1 (cont). Using M4_SYSDEF 
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IF YULI 00 NUT HAVE ANY TO CONFIGURE, REFLY 
"NUNE" TO THE FOLLOWING GUtSllON. 

HOW MANY CARD READER/HUNCHES OR PUSHES DU YUU HAVE/ 

NO 

WE ARt NOW READY TU CUNFIbuRE ALL PRINTER DEVICtS. IE YUU DU NUT 

have any to configure, reply 'NONt' tu the following question. 

HOW MANY PRINTERS DO YOU HAVE? 

1 


PRINTER NUMBER 1 

WHAT CHANNEL NUMBER wILL THIS DEVICE BE UN? 

1780 

.WE ARE NOW READY TO CONFIGURE ALL 9-TRACK MAGNETIC 1APE DEVICES. 

IF YOU DO NOT HAVE ANY TU CONFIGURE, REPLY 'NONt' Tu The FULLQWING 
QUESTION. 

HOW MANY 9-TRACK MAGNETIC TAPE DEVICES uU YOU HAVET 

MAGNETIC TAPE DEVICE NUMBER 1 

WHAT CHANNEL NOMaER WILL THIS DEVICE BE ON? 

1700 

MAGNETIC TAPE DEVICE NUMBER 2 

WHAT CHANNEL number WILL this DEVICE HE on? 

190 0 

if you wish you may optimize all Functions for the greatest 

POSSIBLE SPEED, BUT AT THE EXPENSt OF HAVING A LARGt RESIDENT SYSTEM, 
DO YOU WISH TO HAVE ALL SYSTEM OVERLAYS RESIDENT? (YES OR NO) 

NO 


BY MAKING PARTICULAR UPERATING SYSTEM InPUT/OuIPUT OVERLAYS PtRMANtNTLY 
RESIDENT YOU CAN OBTAIN UPTIMUM SPEED In SOME CATEGORIES. 

DO YOU WISH TO OPTIMIZE THE READING/WRI 11NG UF REL A I I Vt FILES? 

YES 

DO YOU WISH TO OPTIMIZE THE HtADING/WRITING OF RANDOM FILES? 

YES 

DO YOU WISH TO OPTIMIZE The REAOI VO/WRITING UF INDtXEO FILES? 

YES 

DO YOU WISH TO OPTIMIZE RELATIVE PILES WITH uELtlABLE RECURDS? 

YES 

00 YOU WISH TO OPTIMIZE FILE MANAGEMENT OPEN/CLOSE PUNCIIUN5? 

YES 

DO YOU WISH TO OPTIMIZE THE READ I NG/WR I 1 ING UF TAPE FILES? 

YES 

DO YOU WISH TU OPTIMIZE EBCDIC TAPE FUNCTIONS? 

YES 
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00 YOU WISH TO CREATE A BATCH MEMORY POOL? 
YES 

HOW BIG A BATCH POOL? (NNNNN OR NNK WORDS) 

2 Oft 


ENTER THE NUMBER (1 TO 99) OF SYSlEM OVtRLAY ARtAS 
YOU DESIRE. 
f> 

WOULD YOU LIKt TO SEE THE GENERATED STATEMENTS? 

YES 


♦PRODUCED BY INTERACTIVE BUILD (VERSION 2.0). UN 1980/09/04 114b!42..S 
SYS ,,SCIP,b,18,48,,E 

DEVICE CONOO,0,5.X * 040 0',CONSOLE,1 40» , 1 KSR 1 
LOBU CIPSIM 
LDBU SIPS1M_SP 
LOBU ZXPFR 

* 'GCOSfe/MQO 400 VERSION 2.1','TEST SITE ONE' 

RLOCK 

VDAM 

LDBU ZNVOAM 
COMM 9 

A TD 3,11,X'FD80'* #'HI', 'TTY' 

DEVICE AT000f3,ll,X'FD80' 

STTY ATDOO -RECONNECT YES 
ATD 4,12,X'FCOO',,'HI', '7801' 

DEVICE ATD01,4,12,X'FCOO ' 

STTY A T00 1 -RECONNECT YES 

VIP 5,ll,X'FFO0',,,,C,6,TN1200,FU 

DEVICE VIPOO,5,11,X'FFOO ' 

DEVICE ROPOO,fe,ll.X'FFOO' 

VIP 7,12,X'FF80 ' ,,, , T 
DEVICE VIP01.7,12,X'FF80' 

VIP 8,11,X'FEOO',,12 
DEVICE VIP02,8,11,X'FE00' 

H3270 9,11,X'F«80’,,X'7B',X»EA' 

DEVICE H3200,9,11,X'F80O' 

H327 0 i0,U,X'F800',,X'7C',X'EB' 

DEVICE H3201 , 10, 1 1 ,X'F800 ' 

PVE 11,11,X'F900', , 1 
DEVICE PVEOO,11,11,X'F900' 

PVE 12,11,X'F900',,2 
DEVICE PVE01,12,11,X'F900' 

PVE 13,10,X'F980 ' ,,1 
DEVICE PVE02,13,10,X'F980 ' 

PVE 14,10,X'F980',,2 
DEVICE PVE03,14,10,X'F980 ' 

PVE 15,10,X'F 980',,3 
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/fT'X 

V y 


4-46 


CB23-03 


DEVICE PVE04,15,10,X'F980* 
STDLN 12,X'F680' 

STD 16,23,,V7B04 

DEVICE STD0U,16,12,X'F680' 

ROP TN300 

DEVICE STDOl»16,12# X'F680' 
STD 17,24,,V7804 
DEVICE STD02,17,12,X'F680' 
ROP TN300 

DEVICE STD03,17,12» X ' F 6 8 0 ' 


POLIST 

1 




STAPOL 

23,24 




STDLN 

13 , X 1 F600 ' 




STD 18 

,23,,V7700 




DEVICE 

STD04,18, 

14 

* X 

' F 600 

ROP TN1200 




DEVICE 

ST005,18, 

14 


' F 6 0 0 

STD 19 

,24,,V7700 




DEVICE 

STDOb,19, 

14 

r X 

' F 6 0 0 

STD 20 

,25,,V7700 




DEVICE 

STD07,20, 

14 

9 X 

1 F 600 

WOP TIM 1 200 




DEVICE 

STDOB,20, 

14 

9 X 

'FtsOO 

POLIST 

1 




STAPOL 

23,24,25 




BSC 21 

, 10,X'FOOO 

s 

,p 


OEVICE 

BSC 0 0,21 , 

1U 

, x 

'FOOO 

BSC 22 

, 10,X 'F 0 8 0 

* 

t 

,S 


DEVICE 

6SC01.22, 

10 

9 X 

'F 080 

DEVICE 

CONOl ,23, 

lb 

# x 

' 0480 

DEVICE 

OSKOQ , 24, 

16 

# X 

' 0500 

DEVICE 

DSK01,25, 

17 

9 X 

'0580 

OEVICE 

DSK 02 » 26, 

18 

f X 

'1200 

DEVICE 

DSK03,27, 

19 

9 X 

'1280 

* DEVICE R C U 0 0 , 1 

f 6 

f X 

' 1400 

DEVICE 

FCDOO , 28, 

6 t 

X * 

1400 ' 

DEVICE 

RCOO1, 29 , 

20 

f X 

'1480 

DEVICE 

RCMOO,30, 

21 

9 X 

'15 0 0 

OEVICE 

FCMOO,31, 

21 

9 X 

'1500 

DEVICE 

RCM01,32, 

22 

f X 

' 1580 

OEVICE 

FCMO1,33, 

22 

p X 

' 1580 

OEVICE 

MSM00,34, 

24 

9 x 

' 1800 

DEVICE 

MSM01,35, 

2 a 

f X 

' 1880 

DEVICE 

CDROO,36, 

2 b 

9 X 

'2200 

DEVICE 

C DR 0 1,37, 

26 

# X 

'2280 

DEVICE 

LPTOO,38, 

27 

f X 

'1780 

DEVICE 

MT900,39, 

26 

f X 

•1700 

DEVICE 

MT901,40, 

29 

9 X 

•1900 

MEMPOOL S, , 10000 

t P 



MEMPOOL B,,20480 

, P 
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MEMPOOL 

, A tt,*,PC U 

MEMPOOL 

,10,Ab 

MEMPOOL 

,11 , AB 

MEMPOOL 

, L 2 , A 6 

MEMPOOL 

,L3, AB 

MEMPOOL 

#14,AB 

MEMPOOL 

,15,AB 

RESOLA 

0YUPX1 

RESOLA 

rjy^px \ 

RESOLA 

0 V M o X 1 

RESOLA 

OYkKX1 

RESOLA 

OZXINV 

RESOLA 

07 X SUV 

RESOLA 

UZXSUB 

RESOLA 

0 Y [)MK 3 

RESOLA 

OYUMC 

RESOLA 

OYUPC 

RESOLA 

02CINV 

RESOLA 

OZCKfcY 

RESOLA 

UZCLNK 

RESOLA 

OZCPSN 

RESOLA 

OZCSUB 

RESOLA 

OZUCCb 

RESOLA 

OZUSUb 

RESOLA 

OYQMT 

RESOLA 

ozrurL 

RESOLA 

OZ1bTA 

RESOLA 

OZTATE 

RESOLA 

QYQMR2 

RESOLA 

OYUPM 

MAP >SIO>lLM_MAP 

QUIT 



00 YOU WANT TO CREATE THE CL* DIRECTIVE Flit NUW? 

YES 

WOULD YOU LIKt TO USE A FILE NAME UTHER THAN CLM_USER FUR THIS FILt? 
Y E S 

ENTER YOUR FILE NAME -- 

EXAMPLE A 

CLM FILE NAME IS* 

“SYSSRM>UDD>SYS_AUMIiM>SANbQRN>MaK^, 1 >EX AMPLE ^A 
RESTART FILE NAME IS: 

*SYSSR M >UOU>SYS_AUMlN>SANBORN>MaK<s.l>M4R5T.l 


Figure 4-1 (cont). Using M4 SYSDEF 
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Example 2: 


To modify the CLM directive file created in Figure 4 
user invokes the M4 SYSDEF program in rebuild mode/ 
ing the name of the restart file on the command line 
Figure 4-2 illustrates the rebuild mode dialog. 


M 4 _ S V S f) £ F M U y S T . 1 

Y|)1! HA\/f h r ' : T E N E 0 P 4 _ S Y S D E E IN THE PtRUIlfT K1 U06 » 
oil Y HO f.lTiT TO SEE THE- EXISTING CLM S T A I E E: E \ T S ? 
YES 


* P P i. i P11C r P MY INTERACT IV F MHILB C V E E? s r (I N ?.0) , Ow 1980/09/05 
SYS , ,S CIP , b , 1 a ,9 H , , F 

DEVICE c n (I 0,0,5, * ’ 4 II D I , f HSOLE , 140, , 1 K SE 1 

i •)(•! r t p s [m_ 

I..0PII stpsin'pp 
I OH! / X P E P 

* 1 GCijSb /'• f'l; 4 0(1 V p 4 S ] •'. r . 1 ' , ' P F P P t P FI t. I. I- A . ' 

PLf'C-K 

V 0 4 

|_ |! R i I / r! V 0 A <•' 

C'll-’M Q 

Ain < ,i1,x 1 e n« o',,• h i ', • T t y 1 


o e '< I r e a t iM'o, s, 11 , 

Y 

' F I) 8 0 ' 


SriY AT i)0 ii -PEC 1 ! '■■■ 

u 

EC T y E s 


ATP n , 1 ? , .< ' E C 0 o ' , , 

1 

H I ' , ’ 7 S 

0 1 ' 

DEVICE ATI''<> 1,4, IP, 

y 

' F C 0 11 ' 


STTY ATi'OI -hFCDD 

MI-CT y f s 


V[E' 5 , 11 , X ' E E 0 0 ' , , 

r 

, C , h , T !; 

1 F»0() , F 

OF V J r E V T P1 1 0,5 , 1 1 , 

X 

' FFOn ' 


DEVICE Pnpo 10,4,11, 

,x 

' F F 0 0 ' 


VIP 7 , 1 P , x ' F E H 0 1 , , 

t 

, T 


DEVICE vTPOl , / , IP, 

X 

' F F 8 0 ' 


V I p 8 , 1 1 , X ' E Et,n ' , , 

1 ?. 


DEVICE VTpop, e, 1 1 , 

V 

' E F 0 0 ' 


H 3?7 0 9 , 1 1 , X ' F 8 H 0 ' 

» 

, X ' 7 H ' , 

X ' h A ' 

DEVICE H 3?0 0,9 , 1 1 , 

Y 

' F 4 8 (■ ' 


H <?7 0 1 0, 1 1 ,X 'F M 0 0 


, , X ' / C ' 

, x ’ F * 1 

DEVICE h ?PO 1 , 1 o , 11 


X 1 E 8 ,') 0 ' 


P V E 11 , I 1 , X ' E 9 0 0 ’ , 


1 


DEVICE PVE 00 , 1 1 , 1 1 


X ' F 9 (i 0 ' 


P V F 1 ? , 1 1 , x ' E 9 0 0 ' , 


p 


DFVTCF PVE 11 1 , 1 P , 1 1 


X ' F 9 () 0 ' 



Figure 4-2. Using M4_SYSDEF in Rebuild Mode 
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PVF 1 3,10,X'F480',,1 
DEVICE PVE02,13,10,X'F9A0' 

PVE la, 10, X »F9A0 ' , , 2 
DEVICE PVE03, 14, 10, X 'F9 m1' 

PVF 15,10,X'F9A0',,3 
DEVICE PVE04,15,10,X'F9A0 ' 

STDL^ 12,X'F680' 

STD 16,23,,V7604 

DEVICE ST0O0,16,IP,x'FhAO' 

WQP T.V30O 

DEVICE ST0 01,16,IP,X' F 6 A 0 ' 

STD 17,?a,,v780a 

DEVICE STOOP,17,1P,x'F kaO' 

R0P TLL300 

DEVICE STD03,17,1 ?, x»F6A0' 

POL I ST 1 

STAPHl 25,?4 

STOLL 13,X'F6(.0' 

STD 1A,23,,V7700 

DEVICE STDOA, 1 A, 1 3, X »F6<>0 ' 

RQP T Ail 20 0 

DEVICE S T i) 0 5,18,1 3 , x ' F 61 ■ 0 ' 

■STD 1 0,2 4 , , v 7 7 0 0 

DEVICE S T 0 0 6,19,1 <,* 'F60<>' 

STD 20,25,,V 7 7 0 0 

DEVICE S T 0 0 7,20,1 3,x ' F6 u 0 ' 

POP TM200 

DEVICE ST 006,PO,13,X'F6O0 * 

POL 1ST 1 

STAPOL 23,29,26 

BSC 21,10,X 'Eyno ' ,,P 

DEVICE HSC00,2 1 ,1 0 , x ' F nf,o • 

BSC 22,1 0 , x ' F(.)a o ' , , S 
DEVICE BSC«1,22,10,<'Fo*p' 

DEVICE Cn.jO l , 23,15, x * 09 AO ' , , , , ' 7 Aul ' 
DEVICE OSKi'0,2'4, 16, X 1 0500 ' 

DEVICE USK01,25,17,x'OSAO' 

DEVICE 0SKO2,26,1 A,x'12o0' 

DEVICE DSKO3,27,19,x'1?A0' 

* DEVICE 9CDO0, 1,6,X'1900' 

DEVICE F C 0 0 0,2 A,6,X'14 0 0’ 

DEVICE RC001,29,20,x'14A0' 

DEVICf RCMOO,30,?1,X'1500' 

DEVICE FCMOO,51,21,X'1500' 

DEVICE RCM01,32,22,X'15A0• 

DEVICE FCM01,33,22,x'l5A0' 

DEVICF. MSMO0,34,23, X ' 1 AyO • 

DEVICE MSM01,35,24,X' 1 A A 0• 

DEVICE CDR00,36,25,X*2200* 

DEVICE CDR01,37,26,X'2280' 


Figure 4-2 (cont). Using M4 SYSDEF in Rebuild Mode 
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DEVICE LPTOO,J8,27,X'17B0' 

DEVICE MT900,39,28,X'l700' 

DEVICE MT901,40,29,X'1900' 

MEMPOOL S,,10000,P 
MEMPOOL 8,,20480,P 
MEMPOOL » AB,*,PC U 
MEMPOOL ,L0,A8 
MEMPOOL ,L1,AB 
MEMPOOL ,L2,AB 
MEMPOOL ,L3,AB 
MEMPOOL »L«,Afl 
MEMPOOL ,L5,Afl 
RESOLA OVUPX1 
RESOLA OYWRX1 
RESOLA OYROX1 
RESOLA OYRWXl 
RESOLA 07XINV 
RESOLA OZXSOV 
RESOLA 07XSUB 
RESOLA 0YOMR3 
RESOLA 0 YD M C 
RESOLA OYUPC 
RESOLA OZCIMV 
RESOLA OZCKEY 
RESOLA 07CLNK 
RESOLA 07CPSM 
RESOLA OZCSUB 
RESOLA OZUCCH 
RESOLA OZUSUB 
RESOLA 0YD M T 
RESOLA OZTUTL 
RESOLA OZTETA 
RESOLA OZTATE 
RESOLA OYOMR? 

RESOLA OYOPN 
MAP >SID>CLm‘mAP 
QUI T 

DO YOU WISH TO MOO TP Y DEVICES OR SYSTEM PARAMETERS? 

RESPOND WITH ''SYSTEM", "DEVICES", "VIEW", OR "DONE". 

RESPONSE = 

DEVICES 

RESPOND WITH THE OEVlCE TYPE OR CLASS THAT YOU WISH TO MODIFY. 
"COMM", "CON", "DSK", "RCD", "M S M", "CMO", "COR", 

"CRP", "LPT", "MTP", OR "DONE". 

RESPONSE = 

COMM 

DO YOU WISH TO MODIFY ThE COMMUNICATIONS LEVELS AND THE NUMBER OF 

MLCP'S (COMM), THE VIP'S (VIP), THE HOST LINKS (H3270), THE 
PVES (PVE), THE SYNCHRONOUS TERMINALS (STD), 

THE ASYNCHRONOUS TERMINALS (ATD), OR THE BSC'S (880? 

RESPONSE « 

COMM 
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DOES THIS SYSTEM HAVE ANY COMMUNICATIONS TYPE DEVICES? 

I.E., VIPS, TTYS, ETC. 

NO 

00 YOU WISH TO MOl) T F Y THE COMMUNICATIONS LEVELS AND THE NUMBER OF 
MLCP'S (COMM), THE VIP'S (VIP), THE HOST LINKS (H3270), THE 
PVES (PVE), THE SYNCHRONOUS TERMINALS (STD), 

THE ASYNCHRONOUS TERMINALS (A TO), OR THE BSC'S (BSC)? 

RESPONSE = 

DONE 

RESPOND AIT h THE DEVICE TYPE OR CLASS THAT YOU WISH TO MODIFY. 
"COMM", "CON", "OSK", "RCD", "MSM", "C M D", "C D R"« 

"CRP", "LPT", "MTP", OR "DONE". 

RESPONSE = 

DONE 

00 YOU WISH TO MODIFY DEVICES OR SYSTEM PARAMETERS? 

RESPOND WITH "SYSTEM", "DEVICES", "VIEW", OR "DONE". 

RESPONSE = 

SYSTEM 

DO YOU WISH TO MODIFY THE PROMPT (PROMPT), MEMORY SIZE (MEMORY), THE 
NUMBER OF INTERACTIVE USERS (USERS), THE AUTOMATIC GENERATION OF 
SPO NAMES (SPO).THE AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE 
RECORD LOCKING FEATURE (RLOCK), THE SYSTEM OVERLAY AREAS (SO A T), THE 
RESIDENT OVERLAYS (RESOLA), ThF DISPLAY FORMATING FEATURE (VDAM), 

THE COMMERCIAL OR SIP SIMULATORS (SIMUL), 

OR THE SYSTEM AND INSTALLATION IDENTIFICATION (IDEM)? 

RESPONSE - 
RESOLA 


IF YOU.WISH YOU MAY OPTIMIZE ALL FUNCTIONS FOR THE GREATEST 
POSSIBLE SPEFD, HijT AT THE EXPENSE OF HAVING A LARGE RESIDENT SYSTEM. 
DO YOU WISH TO HAvE ALL. SYSTEM OVERLAYS RESIDENT? (YES OR NO) 

YES 

DO YOU WISH TO MODIFY ThE PROMPT (PROMPT), MEMORY SIZE (MEMORY), THE 
NUMBER OF INTERACTTvF USERS (USERS), THE AUTOMATIC GENERATION OF 
SPD NAMES (SPD).ThE AUTOMATIC CHANNEL ASSIGNMENT (CHANNEL), THE 
RECORD LOCKING FEATURE (RLOCK), THE SYSTEM OVERLAY AREAS (30AT), TH£ 
RESIDENT OVERLAYS (RESOlA), ThE DISPLAY FORMATING FEATURE (VOAM), 

ThF COMMERCIAL OR SIP SIMULATORS (SIMUL), 

OR THE SYSTEM AnD INSTALLATION IDENTIFICATION (IDEM)? 

RESPONSE = 

DONE 

DO YOU WISH TO MODTFY DEVICES OR SYSTEM PARAMETERS? 

RESPOND WITH "SYSTEM", "DEVICES", "VIEW", OR "DONE". 

RESPONSE = 

DONE 

WOULD YOU LIKE TO SEE THE GENERATED STATEMENTS? 

YES 


Figure 4-2 (cont). Using M4_SYSDEF in Rebuild Mode 
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♦PRODUCED Hy INTERACTIVE hhilo (VERSION ?.<>), n« 1980/09/05 1434:36.3 
SYS ,,SCIP.b,18,48, , E 

DEVICE CON 0 0 , 0 , 5. x ' 0400 ' , CONSOLE, 1 a 0 , , ' kSK ' 

I.OBU CIPS[M_ 

LDBU SIPSIM^SP 
LDPU ZXPFR 

* 'GCOSh/MOD a 00 VERSION ? . 1 ' , ' PFPPERtLL M.' 

BLOCK 

V OAM 

L.DHU ZNVDAM 

DEVICE CONOl,23,15,X'0480',,,,'78ol' 

DEVICE 0SK00.24, I b. X'eSoO ' 

DEVICE 0 S K 01,25, 1 7,X'0 5 8 0 ' 

DEVICE 0S*02,2fc, I 8,X' 1200 ' 

DEVICE OSK03.27,19,x'1280' 

* DEVICE R C 0 0 u , t > 6 » X ' 1 4 0 0 ' 

DEVICE ECDOO,28,S,X'1uOO' 

DEVICE RC001.29, =>0,X'1 480' 

DEVICE RCMOO,30,?l,X'1SOO ' 

DEVICE FCMOO, 31 , ? 1 , X '1500 ' 

DEVICE RCMOl.32,22,X'15A0' 

DEVICE FCM01 . 33,22.x ' 15A0 ' 

DEVICE MSMOO.34, 53 ,X ' 1 a 00 ' 

DEVICE M$rtOl,35,2a,X'l«80' 

DEVICE CDROO,3h,25,x'2200' 

DEVICE C0R01,37,2b,x'2280 ' 

DEVICE LPTOO,3A,27,X ' 1 7 AO ' 

DEVICE MT900,30,28,x'1 7 00 ' 

DEVICE MT901,40,?9,X 1 1900 ' 

MEMPOOL S,,lOuO0,P 
MEMPOOL R,,20480,P 
MEMPOOL , AP , * , PCI* 

MEMPOOL > L 0 , A 8 

MEMPOOL ,ll,Ap 
MEMPOOL ,L?,AH 
MEMPOOL ,L3,A3 
MEMPOOL ,L«,A8 
MEMPOOL ,L 5,A 8 
CLMIW RE SOL A 
MAP >sI0 >CL w 1mA P 
DU IT 


DO YOU WANT TO CREATE ThE CL m DIRECTIVE FILE MPa? 

YES 

WOULD YOU LIKE TO USE A FILE nAmF OTHER THAN CL M _USFR FOR THIS FILE? 
YES 

ENTER YOUR FILE N A M t -- 
EX AMPLE 

CLM FII..E NAf-’F IS: 

“S YSSRM>UDD>S YS_ADI N>S A NH|)PM>ijCKv>E X AMR) 

RESTART FILE NA >1F TSJ 
*SYSSRM>uDi)>SYS_ADMTN>S Af',PnRN>0n,N>M4kST , 2 


Figure 4-2 (cont). Using M4_SYSDEF in Rebuild Mode 
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SECTION 5 

BASIC CLM DIRECTIVES 


This section describes the CLM directives used to define the 
basic characteristics of the system. The CLM directives for the 
optional communications environment of the system are described 
in Section 6. If you are a first-time user, you should be 
thoroughly familiar with all the topics discussed at the begin¬ 
ning of this section before you create your CLM directive file. 

Appropriately coded CLM directives (including those for com¬ 
munications, if applicable) must be placed in the CLM_USER file 
under directory SID on the bootstrap volume before a stage 2 or 
stage 3 system startup is performed. (The stages of system 
startup are described in Section 3.) 

| 

“■ Table 5-1 summarizes the basic CLM directives, which are 

described in alphabetic order later in this section. Briefly, 
these CLM directives define the following aspects of the system: 

• System variables such as power line frequency, scan cycle 
of real-time clock, Scientific and/or Commercial Instruc¬ 
tion Processor options, number of system overlay areas, 
number of trap save areas, number of intermediate request 
blocks, and expanded error message code option (SYS 
directive) 

• Characteristics and sizes of system memory pool, online 
memory pools, and batch memory pool (if any) (MEMPOOL 
directives) 

• Physical and logical characteristics of MDC-connected 
peripheral devices (DEVICE directives) 

• System overlays that are to be made permanently resident 
(RESOLA directives) 

• Operating system extensions that are to be made perma¬ 
nently resident (LDBU directives) 

< 
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• System physical attributes, system structures, device 
status, user-defined variables, and memory pool specifica¬ 
tions (MAP directive) 

• Single character expressions that may be used in certain 
directives instead of constant values (VARIABLE 
directives) 


• User-written device drivers that are to be made perma¬ 
nently resident and characteristics of the devices driven 
by them (DRIVER directives) 

Table 5-1. Summary of Basic CLM Directives 


Directive 

Meaning 

CLMIN 

Causes subsequent CLM directives to be read from a 
different device/file. 

* (comment) 

Used to include a comment in the file of CLM 
directives. 

DEVICE 

Identifies a peripheral device and its character¬ 
istics, both physical and logical. 

DRIVER 

Identifies a user-written device driver and one 
device driven by it. 

LDBU 

Identifies a bound unit (usually user-written) that 
is to be made permanently resident in the system 
area of memory. 

MAP 

Provides configuration information that allows you 
to verify the success of certain aspects of the 
system building process. 

MEMPOOL 

Defines the system memory pool, the batch memory 
pool, or one or more online memory pools. 

QUIT 

Indicates the end of the input file of CLM 
directives. 

RESOLA 

Identifies one or more system overlays that are to 
be made permanently resident in the system area of 
memory. 

RLOCK 

Defines a pool of structures to be used by data 
management when record locking is requested. 

SYS 

Defines a number of system variables. 

VARIABLE 

Allows you to define variables for parameters in 
certain CLM directive statements. 
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RULES FOR ARRANGING CLM DIRECTIVES 


Only a few rules apply to the order of basic directives in 
the input file read by the Configuration Load Manager. These 
rules are listed below. (Rules governing the order of 
communications-related CLM directives are described near the 
beginning of Section 6.) 

1. Each noncommunications (MDC-connected) peripheral device 
in the system must be identified in a separate DEVICE 
directive. (As described in Section 6, communications 
devices must be identified in DEVICE directives only if 
they are to be accessible through the file system.) 

2. If the operator terminal is connected to an MDC, the 
DEVICE directive for the operator terminal should be the 
first CLM directive. This arrangement allows the opera¬ 
tor terminal to be available for possible error messages 
related to subsequent CLM directives. 

3. If your configuration requires more than the default 
number of trap save areas (7) and/or more than the 
default number of intermediate request blocks (20), a SYS 
directive with appropriate tsa and irb argument values 
should be placed as close as possible to the beginning of 
the file of CLM directives. The additional trap save 
areas and/or intermediate request blocks are available as 
soon as the SYS directive is read. 

4. If the CLMIN directive is used, it must not precede the 
DEVICE directive that identifies the device implied by 
the pathname argument of the CLMIN directive. 

5. If LDBU directives are used to identify both a SIP Sim¬ 
ulator and a Commercial Simulator, the simulator identi¬ 
fied in the latter LDBU directive will be the fir st to 
process a trap to the trap vector shared by the two 
simulators. 

6. A variable must be defined by a VARIABLE directive in the 
CLM file before it can be used in subsequent directives. 

7. QUIT must be the last CLM directive in the input file. 

Any directives that follow QUIT wil not be processed. 
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FORMAT OF CLM DIRECTIVES 


A CLM directive consists of a string of up to 72 ASCII 
characters. The format of a CLM directive is shown below: 

mnemonic argument_l[,argument_2][,argument_3]...[,argument_n] 

In the directive descriptions in this section and in 
Section 6, the following conventions apply: 

1. The directive mnemonic is shown in uppercase. It must be 
specified exactly as shown. 

2. Exactly one space must separate the directive mnemonic 
from the first argument. 

3. In arguments, lowercase words and letters indicate values 
that must be specified by the user. 

4. Arguments within square brackets [] are optional. 

5. Vertically stacked arguments within braces {} represent 
options, one of which must be chosen when the argument is 
used. 

6. Arguments in a directive are separated by commas. 

Embedded blanks are not allowed within arguments. Blanks 
are not allowed between arguments. 

7. A blank terminates the list of arguments in a directive. 
Anything following this blank is considered a comment. 

8. All arguments are positional, meaning that they must be 
specified in the order shown in the directive descrip¬ 
tion. If a given argument is omitted and a following 
argument is used, the omitted argument must be signified 
by delimiting commas (e.g., DEVICE LPT02,15,22, 

X'1380',,,N). 

9. Trailing commas are not required after the last argument. 

10. Continuation lines are not allowed. 

11. Unless stated otherwise, unsigned positive integers less 
than or equal to 65,535 10 (FFFF I6 ) can be expressed in 
decimal or hexadecimal. 

If a value exceeds 65,535 10 , it must be expressed in 
double-word hexadecimal format (i.e., D'hhhhhhhh'). 

A decimal integer consists of one or more decimal digits 
(e.g., 1234) . 
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A hexadecimal channel number consists of the constant 
"X" followed by four hexadecimal digits expressed in the 


format: X'h. 


(e.g., X'FF80') 


12. If an ASCII character string begins with a decimal digit, 
the string must be enclosed within apostrophes (e.g., 
'1A'). 

13. The line length specified for a terminal or other input 
device at system building time overrides the command pro¬ 
cessor line length of 127 characters. For example, at a 
terminal configured with a line length of 80 characters, 
you cannot enter a continuous command line longer than 80 
characters unless you type an ampersand (&) at the end of 
the line and then continue on one or more additional 
lines. You can alter the terminal's line length by using 
the set terminal characteristics (STTY) command (de¬ 
scribed in the Commands manual) after system initializa¬ 
tion or by modifying the STTY directive in your CLM file. 

14. For each noncommunications device configured, you have 
the option of specifying a channel number or allowing the 
system to dynamically assign or "float" channel assign¬ 
ments at startup time. 1 To float a channel, you specify 
the channel number parameter in the appropriate DEVICE or 
DRIVER directive with a single zero (0). The system then 
assigns appropriate devices to any available channels. 
Note that if you specify a zero channel and the system 
cannot locate an appropriate device for it, no error mes¬ 
sage is issued. 

M4_SYSDEF, the interactive CLM directive generation program, 
allows you to float channel numbers for all noncommunications 
devices, if you so choose. See Section 4 for details. 

Channel numbers are assigned according to the order in which 
DEVICE or DRIVER directives with zero (0) channels are specified 
in the CLM file. To prevent devices with zero channels from 
inadvertently preempting devices whose channel numbers are 
explicitly specified, all devices of a given type with explicitly 
specified channel numbers should precede all devices of that type 
with zero channels in the CLM file. 

For noncommunications devices, the first available device 
having the lowest bus address and the correct device identifica¬ 
tion is assigned to the first available MDC-connected DEVICE or 
DRIVER directive encountered in the CLM file, and so on. 


iBy assigning floating channel numbers to devices in the CLM 
file, the system builder need not know the channel numbers at 
each installation that will receive a copy of the system 
software. 
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If a system is configured with devices containing zero chan¬ 
nel numbers, you may determine all channel numbers assigned by 
the system after system initialization. The system operator can 
issue the command STS -ALL to list each device and its channel 
number assignment. 

Specifying a DEVICE KSR directive with a zero channel number 
causes the system to search for the first available MDC-connected 
keyboard/typewriter terminal. If none is available, the system 
will assign an MDC-connected CRT/keyboard terminal to the KSR 
driver. Note that the KSR driver is capable of operating only in 
command mode and single character mode. 

Specifying a DEVICE CON directive with a zero channel number 
causes the system to search for the first available MDC-connected 
CRT/keyboard terminal. If none is available, the system assigns 
an MDC-connected keyboard/typewriter terminal to the CON driver, 
but only if the "terminal-type" parameter (the eighth parameter 
in the DEVICE directive) is specified as KSR or TTY. Note that 
the CON driver operates in field and command modes only. 

The system identifies the presence of a device adapter and 
assumes that the corresponding channel numbers are valid and 
usable. In such a case, the system may associate an unusable 
channel with a physical device. If no device is available to 
satisfy the directive, the user is not informed. If a system 
includes device adapters but not associated devices, then 
explicit channel numbers should be assigned to all devices within 
the device class. 

PRELIMINARY CONSIDERATIONS 

The following paragraphs describe: 

• How to incorporate overlays and user-written bound units 
into your configuration 

• Memory allocation and usage 

• Performance considerations 

• How to identify your peripheral devices 

• How to configure the operator terminal 

• File system pathnames in CLM directives 

You should review each of these topics before you create your CLM 
directive file. 
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System Overlays 


Within the system software, many system functions are imple¬ 
mented as overlays. Each system overlay runs in a 512-word sys¬ 
tem overlay area in the system area of memory. By default, one 
512-word system overlay area is created. If you wish, you may 
use the olan argument of the SYS directive to create additional 
512-word system overlay areas (up to a maximum of 99) so that 
multiple system overlays can be co-resident at any time. In this 
case, the system will not be forced to repeatedly change the con¬ 
tents of the single system overlay area as various system overlay 
functions are required. 

In addition to, or instead of creating multiple system over¬ 
lay areas, you may wish to make certain frequently used system 
overlays permanently resident in the system area of memory 
(increasing its size at the expense of memory available for user 
tasks). This can be done by means of the RESOLA directive. Each 
RESOLA directive allows specification of one or more system over¬ 
lays, each of which is loaded for permanent residency during sys¬ 
tem startup. The names and approximate sizes of all system over¬ 
lays are listed in Appendix B. 

System Extensions 

A system extension is an optional, user-written or system- 
supplied bound unit (consisting of re-entrant code) that is iden¬ 
tified in an LDBU directive and loaded, for permanent residency 
in the system area of memory, during system configuration.' Mul¬ 
tiple system extensions can be used. 

System extensions are most efficient when they are more or 
less continuously used through symbolic references from multiple 
application task groups and this usage does not permit a possible 
delay in the initial loading of the extension. 

System extensions may be used to define system-wide global 
address symbols. These symbols must have been defined in EDEF 
Linker directives as each extension bound unit was linked. 

Later, as the bound unit is loaded during system configuration 
(by virtue of the LDBU directive), the system-wide global address 
symbols are added to the system symbol table, where they can be 
used (by the system loader) to resolve any unresolved references 
to them occurring in subsequently loaded bound units. 

Any dynamic requests for memory originating from a perma¬ 
nently resident system extension are fulfilled from the memory 
pool of the task group that is using the extension. 


i The SYS Linker directive must be used when the system extension 
is linked. 
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Note that if system extension code is not concurrently used 
by multiple applications, it can be individually linked into 
applicable user-written bound units and not loaded for permanent 
residency at system startup. In this case, an LDBU directive is 
not used, and the extension will reside in memory only as part of 
each user-written bound unit with which it has been linked. 
Appropriate symbols in system extensions used in this way can be 
identified in XDEF Assembler control statements and thus resolved 
at link time. 

Memory Allocation and Usage 

System startup allows main memory to be divided into the 
following areas (as a maximum): 

• System area 

• System memory pool 

• Online memory pools 

Exclusive 

Nonexclusive 

• Batch memory pool 

The system area contains resident system software, one or 
more system overlay areas (as specified by the olan argument of 
the SYS directive), any permanently resident system overlays (as 
specified in RESOLA directives), any permanently resident system 
extensions (as specified in LDBU directives), and any user- 
written device drivers (as specified in DRIVER directives). The 
system memory pool, online memory pools, and batch memory pool 
are described in separate MEMPOOL directives (the batch memory 
pool is optional). Each MEMPOOL directive establishes the type 
and size of one or more memory pools. In the case of online 
memory pools, the MEMPOOL directive also establishes (1) the 
2-character identity of each memory pool defined therein and (2) 
whether, for each memory pool defined, additional memory can be 
obtained, as necessary, from the batch memory pool (if any). 

Roots of bound units linked as sharable are loaded into the 
system memory pool, whereas roots of bound units linked as non- 
sharable are loaded into an online memory pool or into the batch 
memory pool. Each task group is associated with one and only one 
memory pool, but more than one task group may be associated with 
the same memory pool. See the System Concepts manual for a more 
detailed description of memory pools. 

ACCESS TO MEMORY POOLS 

Following a system startup, all nondisk devices and files are 
initially accessible to task groups in online memory pools and in 
the batch memory pool (if any). The MFA (modify file) command 
can be used (in an online memory pool task group) to make a 


5-8 


CB23-03 



nondisk device or file inaccessible to the batch memory pool. 
However, when a subsequent system startup is performed, all non¬ 
disk devices and files are once again accessible to task groups 
in online memory pools and in the batch memory pool (if any). 

FRAGMENTATION 

One memory-related phenomenon, "fragmentation," warrants 
mention here. Fragmentation is the development, within a memory 
pool, of unusable "holes" or "fragments" of memory. It usually 
results from the dynamic acquisition and release of memory within 
a pool by a number of concurrently active tasks. Since the sys¬ 
tem's memory manager satisfies dynamic requests for memory within 
a pool on a first-come/first-served basis in consecutive mul¬ 
tiples of 32-word blocks, it is possible that the order of memory 
acquisition and release may create a situation wherein a request 
for memory cannot be satisfied even though sufficient free memory 
exists. 


This situation 
cessfully obtained 


pool's free 


memory 
(e .g. , 


second area 
words), the task's 

successful because _ 

(even though at least 224 words -- the 
available in two nonconsecutive areas) 


might occur, for example, when a task has suc- 
four areas of memory within a pool and the 
is nearly exhausted. If the task released the 
128 words) and the fourth area (e.g., 96 
subsequent request for 192 words might be un- 
that much consecutive memory is not available 
224 


amount released -- is 


Note that if tasks obtain and release memory on a last- 
obtained/first-released basis, the potential for fragmentation is 
reduced, especially when only a few tasks share a particular 
memory pool. 

The potential for fragmentation increases with the number of 
tasks sharing, a memory pool and with these tasks' dynamic use of 
memory. In general , the system memory pool becomes fragmented 
before user memory pools do. Calculations for memory pool size 
later in this section include a factor to allow for potential 
fragmentation. 

Performance Considerations 

• Systems can be configured on hardware having an MMU with¬ 
out utilizing the MMU. This is accomplished by use of CLM 
MEMPOOL directives. If no memory pools are protected or 
contained, and no batch pool exists (or an existing batch 
pool is specified as not contained), then the features of 
the MMU cannot be used. 

• In a given configuration, if any single nonexclusive pool 
has protect and/or contain attributes, all nonexclusive 
pools have the same attributes. 
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• MMU Inrush Overhead 


MMU inrush is defined as the load of MMU by firmware at 
context restore time. 

If pools other than the system pool are protected and/ 
or if pools other than the batch pool are contained, 
there will be an MMU inrush each time any task except a 
system task is scheduled. On a system with an MMU, the 
inrush will take 19 microseconds for SAF and 37 micro¬ 
seconds for LAF. 

If only the system pool is protected and/or only the 
batch pool is contained, there is no MMU inrush over¬ 
head. A single load of the MMU occurs during system 
initialization and the MMU contents are not changed 
unless the system is reconfigured. (The only exception 
is that the MMU contents are temporarily changed at 
batch rollout.) 

If the system is configured without protection or con¬ 
tainment, there is no inrush overhead. 

For configurations in which MMU inrushes occur, a data 
structure of 32 words for SAF (64 words for LAF) is 
required for each protected or contained pool and for 
the set of nonprotected noncontained pools. 

Identifying Peripheral Devices 


Each noncommunications (MDC-connected) peripheral device in 
the system must be identified in a separate DEVICE directive.- 
The device may be designated as accessible through the file sys¬ 
tem or accessible only through physical input/output. (As 
described in Section 6, communications devices must be identified 
in DEVICE directives only if they are to be accessible through 
the file system.) 

The DEVICE directive's arguments specify the characteristics 
of the device: 

• Unique device unit identifier 

• Priority level number 

• Channel number on Megabus 

• Unique logical resource number 

• Unique device name for file system references 

• Maximum record size 

• Buffered/unbuffered input/output 

Configuring the Operator Terminal 

The following paragraphs describe characteristics of the 
operator terminal and the various configuration options available 
to you. 
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OPERATOR TERMINAL CHARACTERISTICS 


The operator terminal is the single device designated as the 
control terminal for the system. It must be assigned to lrn 0 at 
system configuration time in order to be identified by the 
system. 

The operator terminal is the only terminal from which commu¬ 
nication with the system task group $S is possible. Capabilities 
unique to the operator terminal include the creation of the batch 
task group, suspension and reactivation of batch and online task 
groups, peripheral device control, print/punch daemon startup, 
and the monitoring of system status. 

Normally, an operator terminal is configured during a stage 2 
or stage 3 system startup. (An operator terminal is always con¬ 
figured automatically in a stage 1 system startup.) The operator 
terminal may be a terminal connected to an MDC or a terminal con¬ 
nected to an MLCP/DLCP. 

CONFIGURATION OPTIONS 

As the system builder, you have three options with respect to 
configuring the operator terminal: 

• You can configure a terminal that will function as the 
operator terminal for the life of the system. 

• You can configure a dual-purpose terminal that can func¬ 
tion alternately as an operator terminal and as a non¬ 
operator terminal. 

• You can choose not to configure an operator terminal. 

You might choose the first option if you wish to always have 
one terminal reserved for the operator's exclusive use. This 
terminal would always have the capability to perform those con¬ 
trol and administrative functions unique to the operator. Note 
that the operator terminal cannot support forms processing 
software. 

The second configuration option allows you to assign a dual 
function and identity to the operator terminal. You assign two 
unique names to the terminal: a "device name" that identifies 
the terminal when it is functioning as a non-operator terminal, 
and an "operator terminal name" that identifies the terminal when 
it is functioning as an operator terminal. You might choose this 
configuration option if operator functions will be infrequently 
performed and you wish to free the operator terminal for user 
applications (especially forms processing). The ability to 
perform forms processing will only be available to users when the 
terminal is functioning as a non-operator terminal. 
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Operating procedures for an operator's console configured by 
one of the above methods are fully described in the Operator's 
Guide . 

The third configuration option does not permit commands and 
procedures unique to the operator terminal to be performed. You 
might choose this option if your system configuration will run 
under a dedicated application. 

Configuring an Operator Terminal to Function for the Life 
of the System 

A device configured to function as the operator terminal for 
the life of the system will always allow users the capability to 
perform those control and administrative functions unique to the 
operator. 

If the permanently assigned operator terminal is connected to 
an MDC, the operator terminal must be identified by a DEVICE 
directive. This DEVICE directive should be first in the CLM 
directive file so that the operator terminal is available to 
receive any error message that relates to subsequent CLM 
directives. 

If the permanently assigned operator terminal is connected to 
an MLCP/DLCP, both a DEVICE directive and an appropriate communi¬ 
cation directive (e.g., ATD) are required. (A COMM directive is 
also required.) An MLCP/DLCP-connected operator terminal is 
activated only after system startup is complete. 

In either case, the logical resource number on the DEVICE 
directive must be explicitly specified as 0. Any appropriate 
level number and channel number may be specified. The record^ 
size argument should normally be set at 140 bytes (characters). 
Note that the specified record size affects only the file sys¬ 
tem's use of the operator terminal; regardless of the value of 
record_size, the Operator Interface Manager always uses 140 char¬ 
acters as the maximum for i ts control of input and output opera¬ 
tions to the operator terminal. The device name of the operator 
terminal may be any user-selected name (customarily, CONSOLE is 
used) . 

Example 1: 

DEVICE CON00,0,8,X'0500' ,CONSOLE,140,N,'7 20 0' 

In this example, the operator terminal is connected to an 
MDC. The device unit name is CON00. The logical resource 
number is 0 (a requirement for the operator terminal). The 
priority level is 8. The channel number is 0500. The device 
name is CONSOLE. The record size for file system access is 
140 bytes. I/O to the device will be unbuffered. The termi¬ 
nal is a VIP7200. The default for visual display mode, 'T', 
has been accepted. 
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Example 2: 


COMM 9 

DEVICE TTY00,0,11,X'FF8 0 *,CONSOLE,140 
TTY 0,11,X'FF80' 


In this example, the operator terminal is connected to an 
MLCP. The device unit name is TTY00. The logical resource 
number is 0 (a requirement for the operator terminal). The 
priority level is 11. The channel number is FF80. The 
device name is CONSOLE. The record size for file system 
access is 140 bytes. In the COMM directive, 9 is the prior¬ 
ity level at which the MLCP will interrupt the central 
processor. In the TTY directive, default values have been 
accepted for modem type and line speed. 

Configuring a Dual-Purpose Operator Terminal 

You have the option to configure a dual-purpose operator 
terminal. A dual-purpose terminal can function alternately as an 
operator terminal and as a non-operator terminal. Only one 
device in your configuration may be configured in this manner. 
Users control in which capacity the terminal functions (as an 
operator terminal or non-operator terminal) by means of the OPER 
command described later in this section. 


If the device that will function alternately as an operator 
terminal and a non-operator terminal is connected to an MDC, the 
device must be identified by a DEVICE directive with the first 
parameter as CONnn. This DEVICE directive should be the first in 
the file of CLM directives so that the terminal is available Eo 
receive any error message that relates to subsequent CLM 
directives. 


For an MDC-connected device, the directive is of the form: 


DEVICE 


CONnn,lrn 
N,termina 


, level,X'channel' 


1 type. 


{ 5 } 


, o pe r a 


device name,record 
tor terminal name 


si ze, 


If the device is connected to an MLCP/DLCP, both a DEVICE 
directive and an ATD directive are required. (A COMM directive 
is also required.) An MLCP/DLCP-connected operator/non-operator 
terminal is activated only after system startup Is complete. It 
is recommended that the terminal not be a dialed line. 


For an 
are of the 


MLCP-connected device, 
fo rm: 


the ATD and DEVICE directives 


DEVICE ATDnn,lrn,level,X'channel',device_name,rec_size , 
N,,,operator_terminal_name 

ATD lrn,level,X'channel',modem,speed,device_type,[del], 
[stop-bit][,parity] 


5-13 


CB23-03 


In either case, the logical resource number (lrn) on the 
DEVICE directive must be explicitly specified and must be non¬ 
zero. The lrn you specify will be assigned to the device and the 
file having the name "device name" (fifth parameter). The system 
implicitly assigns lrn 0 to the file having the name "operator_ 
terminal_name" (tenth parameter). Lrn 0 may not be assigned to 
any other device. An appropriate level number and channel number 
may be specified. The device name (fifth parameter) you specify 
will be assigned to the terminal when it is functioning as a non¬ 
operator terminal. An application task group's standard I/O 
files (e.g., command-in, user-in) will be assigned to the device 
name you specify. 1 You must specify that this device is unbuf¬ 
fered; the seventh parameter must be N. 

For an MDC-connected terminal, the tenth parameter in the 
DEVICE directive designates this device as being able to function 
as both an operator terminal and a non-operator terminal. For an 
MLCP/DLCP-connected terminal, the tenth parameter, operator 
terminal name, must be separated from the seventh parameter7 N, 
by exactly 3 commas. The operator terminal name you specify will 
be assigned to users' standard I/O files when the terminal is 
functioning as an operator terminal. CONSOLE is the customary 
designation . 2 

Example 1: 

DEVICE CON00,9,12,X'138 0',VIP01,100,N,'7200’ ,,CONSOLE 

In this example, the operator terminal is connected to an 
MDC. The device unit name is CON00. The logical resource 
number (lrn) is 9. The explicitly stated lrn value of 9 is 
assigned to the terminal when it functions as a non-operator 
terminal. An lrn of 0 is implicitly assigned to the terminal 
when it functions as an operator terminal. The priority 
level is 12. The channel number is 1380. The name assigned 
to the terminal when it is functioning as a non-operator 
terminal is VIP01. The record size for file system access is 
100 bytes. The seventh parameter must be N, specifying that 
this device is unbuffered. The terminal type for this device 
is 7200. The default for visual display mode has been 
accepted. The name assigned to the terminal when it is func¬ 
tioning as an operator terminal is CONSOLE. 

Example 2: 

COMM 8 

DEVICE ATD00,9,15,X'FF80',VIP00,80,N,,,CONSOLE 

ATD 9,15,X'FF80',0,9600,7200 

1 bnl'y”one appl ication task group can be assigned to the device 
name you specify. 

2 Any number of application task groups can be assigned to the 
operator terminal name you specify. 
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In this example, the operator terminal is connected to an 
MLCP. The device unit name is ATDOO. The logical resource 
number is 9. The explicitly stated lrn value of 9 is 
assigned to the terminal when it functions as a nonoperator 
terminal. An lrn of 0 is implicitly assigned to the terminal 
when it functions as an operator terminal. The priority 
level is 15. The channel number is FF80. In the COMM 
directive, 8 is the priority level at which the MLCP/DLCP 
will interrupt the central processor. 

In the DEVICE directive, the name assigned to the device when 
it is functioning as a non-operator terminal is VIPOO. The 
record size for file system access is 80 bytes. The terminal 
must be designated as unbuffered (the seventh parameter must 
be N) . The name assigned to the terminal when it is func¬ 
tioning as an operator terminal is CONSOLE. 

In the ATD directive, the modem type is 0 (direct connect). 
The line speed is 9600. The device type is 7200. Defaults 
have been taken for del, stop-bit, and parity. 

At system startup, the terminal is running under the system 
task group and functions as an operator terminal. The ini¬ 
tial switch from operator control to user control must be 
accomplished through an EC file you create. The location and 
purpose of this EC file should be communicated only to 
selected users. 


The EC file must contain the following commands: 


OPER -OFF 


-IM 

-DEF 


SG group_id user_id level user_in -WD path -POOL pool_id 

The OPER -OFF command transfers control of the terminal from 
operator control to user control. The -IM control argument 
(the default) allows all messages processed by the Operator 
Interface Manager (OIM) to be displayed while the terminal is 
running under an application task group. 

The -DEF control argument defers all OIM-processed messages 
until the terminal is returned to system task group control. 
However, messages sent to the terminal by two system rou¬ 
tines, OPMSG and OPRSP, are never deferred. These messages 
are displayed immediately to allow the operator or user to 
respond to volume mount requests or 'device not ready' mes¬ 
sages. Messages sent to the terminal from other terminals 
using the MSG command are also not deferred. If a user 
specifies the -DEF argument and the OIM has deferred an 
output order, the OIM will issue a message at regular inter¬ 
vals stating that output is pending. 
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The spawn group (SG) command initiates the appropriate user 
group for the application. The spawn group command creates 
an application task group whose lead task must be the command 
processor. (The CG and EGR commands may be substituted for 
the SG command.) The user-in file must be the same as the 
'device name' specified in the DEVICE directive when the 
terminaT was configured. 

If a user wishes the terminal to function as an operator 
terminal, he must execute the command OPER -ON. A message 
will appear at the terminal stating "OPERATOR HAS CONTROL". 

If at any time, a user wishes to return control of the termi¬ 
nal to his application task group, he must type the command 
OPER -OFF. 

System Configured Without Operator Terminal 

A system configured without an operator terminal has the 
following characteristics': 

• A $OPMSG (operator information message) or $OPRSP 
(operator response message) macro call to the nonexistent 
operator terminal results in a 0802 error return (invalid 
logical resource number) to the issuing application. 

• No operator terminal is available to record system error 
messages, ready device messages, and mount volume mes¬ 
sages. As a result, error returns to the issuing applica¬ 
tion occur immediately: 

- An input/output order to a device that is offline or not 
ready results in a 0105 error return (device not ready) 
to the application. 

- A GET command or $GTFIL (get file) macro call to reserve 
a volume that is not mounted results in a 020C error 
return (volume not found) to the application. 

- A read or write hardware error results in a 0107 error 
return (hardware error) to the application. 

• No system-supplied message can be issued to signal the 
termination of system startup. 


i In a system configured with an operator terminal, these same 
characteristics apply within any task group that has used the 
$CMSUP (console message suppression) macro call to temporarily 
suppress messages to the operator terminal. 
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File System Pathname in CLM Directives 


Whenever the format of a Configuration Load Manager (CLM) 
directive indicates that a file system pathname is to be supplied 
as an argument, the pathname must be expressed in one of three 
forms: 

1. A full absolute pathname. 

This form of pathname is required to identify a file on a 
disk volume other than the system (bootstrap) volume. 

A full absolute pathname begins with a circumflex (~) and 
a disk volume root directory name (which is the same as 
the volume id). Each successive element in the pathname 
is preceded by a greater-than sign (>) and is hierarchi¬ 
cally subordinate to the preceding element. Every ele¬ 
ment in the pathname except the last is a directory name. 
The last (rightmost) element is a file name.' The last 
element is not followed by any symbol or punctuation. 

Example: 

CLMIN ~USRV0L>DIR_1>FILE_A 

In this example, a full absolute pathname is used in a 
CLMIN directive. The pathname indicates a target file 
that exists on a disk volume other than the system 
(bootstrap) volume. 

2. An absolute pathname. 

This form of pathname is used to identify a file on the 
system (bootstrap) volume or a nondisk peripheral device. 

An absolute pathname begins with a greater-than sign (>) 
and the name of a directory or file that is immediately 
subordinate to the root directory of the system vplume.2 
'The rest (Tf any) of the pathname is similar to the full 
absolute pathname described above. 

iIn non-CLM environments, the last element in a pathname may be 
either a directory name or a file name, as appropriate to the 
situation. 

2 For a magnetic tape file, the absolute pathname must be !device_ 
unit>volume_id>file name. The value for device_unit must be 
specified in the reTated DEVICE directive. 

For other nondisk peripheral devices, the absolute pathname must 
be I device_name. The value for device name is as specified in 
the related DEVICE directive. (If devTce_name is not specified 
in the DEVICE directive, the value of the device_unit argument 
is used for device name.) 
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Example : 


DRIVER >DIR_Y>USRDRV 

In this example, an absolute pathname is used in a DRIVER 
directive. This pathname indicates a target file that exists 
on the system volume. DIR Y is a directory immediately sub¬ 
ordinate to the root directory of the system volume. 

3. A relati ve pathname. 

During execution of the Configuration Load Manager, this 
form of pathname is used to identify a file in the system 
task group's working directory, in this case directory 
SID, which is immediately subordinate to the root direc¬ 
tory of the system volume. ("Relative" means relative to 
the working directory of the task group.) 

In this situation, the relative pathname is expressed as 
a simple file name with no preceding or following symbols 
or punctuation. 1 The named file must exist in directory 
SID on the system volume. 

Example: 

LDBU RBRCIP 

In this example, a relative pathname is used in an LDBU 
directive. This pathname indicates a target file that 
exists immediately subordinate to directory SID on the 
system volume. 

In all types of pathnames, a directory name cannot exceed 12 
characters, a file name cannot exceed 12 characters, and the 
total pathname (including ~ and > characters) cannot exceed 57 
characters. In a full absolute pathname, the volume root direc¬ 
tory cannot exceed six characters. The first character of each 
directory name and each file name must be alphabetic or a dollar 
sign ($). 


pathname exist, but their use with 


the Configuration Load Manager is discouraged. 
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CLMIN 


CLMIN DIRECTIVE 


Directive Name: CLMIN 


A CLMIN (CLM i 
directives to 
one indicated 
directives are 
too contains a 


nput) directive 
be changed from 
by the pathname 
read from the 
CLMIN directiv 


causes the source of CLM 
the current device/file to the 
argument. All subsequent CLM 
indicated device/file (unless it 
e) . 


Format: 


CLMIN pathname 


Argument Description: 
pathname 

Consists of an ASCII string that identifies the file sys¬ 
tem pathname from which subsequent CLM directives will be 
read. 


Functional Description: 

In a file of CLM directives, a CLMIN directive cannot appear 
ahead of the DEVICE directive that identifies the device 
implied by the pathname argument. 


When a CLMIN directive is read by the Configuration Load 
Manager, the input file is immediately transferred to the 
beginning of the device/file indicated by the pathname. 
Subsequent CLM directives are read from the indicated device/ 
file. 

If a disk or magnetic tape volume is indicated by pathname, 
that volume must be mounted before system startup begins. 

Example 1: 


CLMIN ~ABCVOL>B ETA1 


In this example, subsequent CLM directives will be read from 
a file named BETA1 on disk volume ABCVOL. An absolute disk 
pathname is used. Volume ABCVOL must be mounted on a disk 
device whose DEVICE directive has already been read by the 
Configuration Load Manager. 
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CLMIN 


Example 2: 

CLMIN ICDROO 

In this example, subsequent CLM directives will be read from 
card reader whose device_unit name is CDROO. (Assume that 
the DEVICE directive for CDROO did not include a device name 
argument; in this case, the device_unit argument value Ts 
used for file system references to the device.) The DEVICE 
directive for CDROO must already have been read by the Con¬ 
figuration Load Manager. 
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( 


COMMENT 


COMMENT DIRECTIVE 

Directive Name: * (asterisk) 

The COMMENT directive is used to include a comment in the 
file of CLM directives. 

Format: 

* comment text 
Functional Description: 

When a * (asterisk) is the first character of an entry in the 
file of CLM directives, the remainder of the entry is treated 
as a comment and is not processed by the Configuration Load 
Manager. 

Comments can also be included on other CLM directives if they 
follow a blank after the last argument of the directive. 
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DEVICE 


DEVICE DIRECTIVE 

Directive Name: DEVICE 

A DEVICE directive is required for each MDC-connected periph¬ 
eral device in the system. You may allow the system to 
dynamically assign channel numbers to appropriate devices on 
the bus. You must include a special format of the DEVICE 
directive in your CLM file if your installation will use a 
dual-purpose operator terminal. Refer to "Configuring a 
Dual-Purpose Operator Terminal" earlier in this section. 

Fo rmat: 

DEVICE device_unit,lrn,level,X'channel',[device_name], 

[ record_si ze] , [{n }] ,['terminal-type'] [,C/T] 

Argument Description: 
device_unit 

A string of five ASCII characters. The first three char¬ 
acters identify the type of device; the last two charac¬ 
ters (alphanumeric) must be unique within the device type 
so as to identify one specific device of that type. 

Table 5-2 indicates the permissible values of device 
unit, the device type indicated by each value, and the 
default physical record size (in bytes) for each device 
type. 

Except where indicated, the default record size can be 
overridden by use of an explicit record_size argument in 
the DEVICE directive. 

In the case of KSRnn, the device unit argument also 
establishes the following characteristics for the 
terminal: 

• Trailing carriage return option specified. 

• Trailing line feed option specified. 

• Leading control byte option specified. 

• Echo mode option specified. 

/f 


5-22 


CB23-03 



If you wish to change any of these characteristics of the 
terminal, you can do so by means of an STTY (set terminal 
characteristics) command, a $STTY macro call, or a STTY 
directive. 


Table 5-2. Unit Values and Default Record for Various Devices d 


Device Unit 
Val ue 

KSRnn/CONnn 

LPTnn 

SPTnn 

CDRnn 

CRPnn 

DSKnn 

RC Dnn 

FCDnn 

MSMnn 

RCMnn 

FCMnn 

MT7nn 

MT9nn 


Device Type Indicated 

Terminal (MDC-connected ) d 

Line Printer 

Serial Printer 

Card Reader 

Card Reader/Punch 

Diskette 

Removable Cartridge Disk 
Fixed Cartridge Disk 
Mass Storage Unit 
Removable Cartridge Module 
Disk 

Fixed Cartridge Module Disk 
Magnetic Tape (7-track) 
Magnetic Tape (9-track) 


Default Physical 
Record Size in 
Bytes (Decimal) 

KSR-73 CON-80 
137 
133 
80 
80 

128 b 


256 b 


a The KSR device_unit value is included for compatibility 
with previous releases. The CON device_unit value 
should be used when creating a new CLM directive file. 
The CON device unit value must be used if the user 
intends to perform forms processing from an MDC- 
connected VIP 7200 or VIP 7205 terminal. Using the KSR 
device_unit value and the CON device_unit value will 
cause two different device handlers to be loaded. 

b The default record size for this device cannot be 
altered by means of the record size argument of the 
DEVICE directive. 

c It is not necessary to issue a GET command or a $GTFIL 
(get file) macro call to establish the logical record 
size (and block size). The record size cannot be 
altered by the record_size argument of the DEVICE 
directive. 


Communications devices are described in Section 6 
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DEVICE 



DEVICE 


lrn 


Specifies the logical resource number by which the device 
is requested. The value for lrn is a decimal integer 
from 3 through 252. (lrn 0 is used for the operator 
terminal. lrn 1 is used for the bootstrap device. lrn 2 
is reserved for system use.) 

level 

Specifies the priority level used by the device driver 
for this device. The value for level is a decimal 
integer from 7 through 59. 

X'channel' 

Specifies the 4-digit hexadecimal channel number of the 
device. (The leftmost 10 bits specify the channel 
number; the rightmost six bits must be zero.) 

If you specify the channel number by a single zero (0), 
the system will automatically assign this device to an 
appropriate channel. 

If a DEVICE directive for a disk device contains an lrn 
of 1 and a channel number of zero, the bootstrap device 
channel number replaces the channel number of zero. 

[device_name] 

For disk and magnetic tape devices, the device_name argu¬ 
ment must be omitted or specified as * (asterisk) because 
the device identity is established by the value of the 
device_unit argument. (The significance of using the 
asterisk is described below.) 

For devices other than disk or magnetic tape, device_name 
can be one of the following: 

1. A string of up to 12 ASCII characters that establish 
a unique name by which the device is referred to 
within the file system. The first character of the 
string must be alphabetic. 

2. Omitted, in which case the value of the device_unit 
argument is used for file system references to the 
device. 

3. A * (asterisk), which indicates a "private" device to 
be accessible only through physical input/output. 
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[record size] 


The length, 
size is not 
established 
record size 
modified by 


in bytes, of one physical record. If record_ 
specified, the default record size is as 
by the device_unit argument. (The default 
for disk devices and magnetic tapes cannot be 
the record size argument.) 



This argument is meaningful only for devices other than 
disk and magnetic tape. 


For normally unbuffered devices (viz., CDR, CRP), B indi¬ 
cates that input/output to the device is to be buffered. 

For normally buffered devices (viz., CON, KSR, LPT, SPT), 
N indicates that input/output to the device is to be 
unbuffered. 


Input/output to a buffered device may be either asynchro ¬ 
nous or synchronous ; tabulation characters are expanded 
into space characters. Input/output to an unbuffered 
device is always synchronous; tabulation characters a"re 
not expanded. 

NOTE: All arguments of a DEVICE directive must be unique 

(i.e., not duplicated on another DEVICE directive) 
with these exceptions: (1) the B/N argument need not 
be unique, (2) for pairs of removable/fixed cartridge 
disks, the same level number and channel number must 
be specified for both platters (3) multiple communica¬ 
tions devices may be configured on the same level and 
(4) multiple (polled) VIPs may be configured on the 
same channel. 

['terminal_type'] 

Applies only if the device_unit value is CON. Specifies 
the physical terminal type. Possible values are 
described below: 
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DEVICE 



DEVICE 


Val ue 


Physical Device Type 


'7200' VIP 7200 (DKU9103) 

VIP 7205 (DKU9102) 

The value 7200 must be used if MDC-connected 
VIP 7200 terminals are to be used for forms 
processing using the Display Formatting and 
Control facility. 

| 'PRU' PRU1001/PRU1003/PRU1005/TWU1001/TWU1003/TWU1005 

'D7200 1 VIP 7207 

'KSR' The value KSR is used if the physical termi¬ 
nal type is to be supported in teleprinter 
* mode. 

[C/T] 

Applies only if the device unit value is CON. Specifies 
the visual display mode foF the device. The value C 
indicates CRT mode. The value T indicates teleprinter 
mode. If C is specified, typed input will appear without 
edit control characters (as it appears in the memory 
buffer). If T is specified, typed input will appear as 
it was keyed-in. The default value is T. 

Functional Description: 

Each peripheral device in the system must be identified in a 
separate DEVICE directive. The device unit argument (e.g., 
DSK01) identifies both the type of devTce (DSK) and one 
specific device (01) of the indicated type. The lrn"^ Tevel, 
and channel number of each device must be unique (except in 
the case of a pair of removable/fixed cartridge disks, in 
which case the level and channel for both platters must be 
the same). 

The first DEVICE directive for each device type causes the 
appropriate device driver to be loaded as part of the system. 
Each device driver is re-entrant, so that only one copy of 
each required driver is loaded to service all devices of the 
same type. 

A DEVICE directive for the bootstrap device is optional. If 
none is specified, the bootstrap device is assigned priority 
level 6 (the default). If you wish to override the default 
priority level, you should specify a DEVICE directive that 
indicates the appropriate device_unit, logical resource num¬ 
ber 1, desired priority level, and a channel number of zero 
(e.g., DEVICE DSK00,1,level,X'0'). If the channel number is 
not zero, the following message is issued: 1345 CMD (DEVICE) 
SPECIFIES DUPLICATE DEVICE TYPE/UNIT. 
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Example 1: 


DEVICE LPT01,12,20,X'1380' 

In this example, the line printer whose unit number is 01 is 
assigned logical resource number 12 and priority level 20. 
This device is connected to channel 1380. The following 
characteristics are established by default: 

• The device_name used within the file system will be the 
same as the device unit (i.e., LPT01). 

• The record size will be 137 bytes. 

• Output to the device will be buffered. 

Example 2: 

DEVICE RCD01,9,10,X'1400' 

DEVICE FCD01,6,10,X'1400' 

This example illustrates DEVICE directives for a pair of 
removable/fixed cartridge disks. The logical resource number 
for each platter must be unique. The level and channel 
number for both platters must be the same. 
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DEVICE 



DRIVER 


DRIVER DIRECTIVE 


Directive Name: DRIVER 

The DRIVER directive is used to identify a user-written 
device driver and one device driven by the driver. 

Format: 

DRIVER pathname,lrn,lev el, X'channel'[,X'stack_size| 
RCT_size'][,X'hhhh'] 

Argument Description: 

pathname 

An ASCII string that identifies the file system pathname 
of the device driver bound unit. 

lrn 

Specifies the logical resource number used to identify a 
device driven by this driver. The value for lrn is a 
decimal integer from 3 through 252. 

level 

Specifies the priority level used by the device driver. 
The value for level is a decimal integer from 7 through 
59. 

X'channe1' 

Specifies the 4-digit hexadecimal channel number of a 
device driven by this driver. (The leftmost 10 bits 
specify the channel number; the rightmost six bits must 
be zero.) You have the option to allow the system to 
assign a channel number for this device by specifying a 
single zero for this argument. If you choose this 
option, you must also specify the X'hhhh' argument 
described below. 
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[X ' stack_si ze I RCT_si ze ' ] 

Specifies the sizes in words of (1) the stack required by 
this driver and (2) the resource control table (RCT) used 
for a device driven by this driver. The sizes are speci¬ 
fied by a four digit hexadecimal number: the leftmost 
two digits specify the stack size; the rightmost two 
digits specify the RCT size. If the stack size and/or 
the RCT size exceed 255 words (decimal) you may use the 
double word hexadecimal format, D'hhhhhhhh', where the 
first four hexadecimal digits represent the stack size 
and the second four hexadecimal digits represent the RCT 
size. If the driver is to use the system routine ZIOSUB, 
the stack size must be at least 22 words for a SAF con¬ 
figuration and 40 words for a LAF configuration. The 
minimum size for the RCT is 3 words. If a smaller value 
is entered, the system replaces it with 3. The default 
values are 8 words for stack size and 16 words for RCT 
size. You must take the default values for both sizes or 
specify both. You cannot specify one and take the 
default for the other. 

[X ' hhhh' ] 

Specifies a four-digit hexadecimal number corresponding 
to the internal hardware id of the device being driven 
by this driver. 

Functional Description: 

The DRIVER directive causes the user-written device driver 
identified by the pathname argument to be loaded into the 
system area of memory. (Because this driver is loaded into 
the system area of memory, the SYS Linker directive must have 
been specified when this bound unit was linked.) The user- 
written device driver becomes a permanently resident part of 
the system software. (If the driver includes initialization 
routines to be executed when the driver is loaded, these rou¬ 
tines also remain permanently resident.) 

The DRIVER directive causes creation of a resource control 
table (RCT) of the indicated size. It also causes creation 
of a task control block (TCB) with a dedicated priority 
level. Additional data structure initialization is achieved 
as described below. 

The data structures allocated for use by this device driver 
are sufficient only for physical input/output operations. 

The RCT will be used by the driver to interface with the 
indicated device. Input/output from a program can be ini¬ 
tiated by a $RQIO (request input/output) macro call that 
identifies an appropriate input/output request block (IORB). 
(The format of the IORB is described in the System Service 
Macro Calls manual.) 


5-29 


CB23-03 


DRIVER 




DRIVER 


Each user-written device driver runs at a dedicated (unique) 
priority level. If a given device driver (single task) 
drives multiple devices on different channels, one DRIVER 
directive is required for each device. Each DRIVER directive 
must specify a unique lrn and channel number, and a common 
priority level and pathname (see the example). In this case 
a separate RCT and stack are created for each device but a 
common TCB is used. Multiple devices of the same type, each 
with its own work area, are thus driven at a common priority 
level by a common task. (If a given device driver drives 
multiple tasks, the pathname arguments in each DEVICE 
directive must be identical, but each task must have a unique 
priority level.) 

The initialization of data structures caused by the DRIVER 
directive is summarized below. 

• An RCT of the indicated size is created. Immediately 
below the RCT, space for a pointer to the TCB is provided; 
one word for a SAF system, two words for a LAF system. 

• The RCT is immediately preceded by a TCB pointer which is 
in turn immediately preceded by the stack. 

• The pointer at the appropriate lrn offset in the logical 
resource table (LRT) is set to point to the channel/level 
word (the first word) of the RCT. 

• The TCB pointer immediately below the RCT is set to point 
to the TCB. 

• The channel and level values of the DRIVER directive are 
entered into the channel/level word of the RCT. 

• The RCT is marked as having no volume descriptor block 

(private volume). Thus the device is accessible only 

through physical input/output (normally, the $RQIO macro 
call) and not through the file system. 

• The TCB is marked as having a dedicated priority level. 

(The TCB is also set to point to the entry point of the 

device driver.) 

• The remaining area of the RCT is set to zero. The driver 
must initialize the RCT as required. 

Example: 

DRIVER DIRECT0RY_1>OWN_DRIVER,12,9,X'0300' 

DRIVER DIRECTORY 1>0WN DRIVER,13,9,X'0380' 
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In this example, a user-written device driver whose file name 
is OWN_DRIVER is identified. It will be used to drive two 
devices’ under a single task. The level and pathname argu¬ 
ments of the two DRIVER directives are the same; the logical 
resource numbers and channel numbers for the devices are 
unique. The RCT for each device will be 16 words. The size 
of the stack required by this driver is 8 words. 
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LDBU 


LDBU DIRECTIVE 

Directive Name: LDBU 

The LDBU directive causes the indicated bound unit to be 
added to the end of the bound unit load list. The bound 
unit's root is loaded into the system area of memory after 
all CLM directives have been read. (Since the root of the 
bound unit will be loaded into the system area of memory, the 
SYS Linker directive must have been specified when this bound 
unit was linked.) Once loaded, the root of the indicated 
bound unit is permanently resident in the system. 

If you wish to incorporate an optional system capability into 
your configuration, such as error logging or defective memory 
trap handling, you might be required to load one or more 
bound units using LDBU directives. Refer to Sections 7 and 8 
for descriptions of the bound units associated with optional 
system capabilities. 

Format: 

LDBU pathname 

Argument Description: 
pathname 

An ASCII string that identifies the file system pathname 
of the bound unit. 

Functional Description: 

Application-specific code (usually in the form of subroutines 
shared among multiple task groups) that is referred to sym¬ 
bolically during application execution can be permanently 
brought into memory at system startup by LDBU directives. 

The pathname in each LDBU directive is added to a bound unit 
load list. 

The order of LDBU directives governs the order in which path¬ 
names are added to the list. If two LDBU directives specify 
the same pathname, the second one is ignored. 
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After the QUIT directive (the last CLM directive) is read by 
the Configuration Load Manager, the roots of the bound units 
identified by LDBU directives are permanently loaded into the 
system area of memory. The symbol table for each such bound 
unit is added to the system's resident symbol table list. 

Once a bound unit has been loaded, any symbol defined therein 
by an EDEF Linker directive serves to resolve an unresolved 
reference to that same symbol in a subsequently loaded bound 
unit. Otherwise, if a bound unit contains an unresolved 
reference to a symbol, loading stops with an error halt. 

Example: 


LDBU 


v ABCV0L>ALPHA1 


In this example, a bound unit named ALPHA1, which is a file 
immediately subordinate to the root directory of a volume 
named ABCVOL, will be added to the bound unit load list. 

A bound unit loaded by means of the LDBU directive may con¬ 
tain an initialization subroutine table (1ST). The 1ST defines 
one or more subroutines of the bound unit that are to be executed 
once only, immediately after the root is loaded. If a bound unit 
contains initialization subroutines, the Linker directive 1ST 
must be specified when the bound unit is linked. The label in 
the 1ST section is the argument to be entered in the 1ST 
directive. 


The format of an 


1ST section is given 


below: 


DC 

O 1 



RES V 

$AF, 0 

RFU 


DC 

<subl ) 

parameters to subroutine subl 

(may 

DC 

0 ( 

be any sixteen bit value) 


DC 

0 * 



DC 

<sub2 ) 

parameters to subroutine sub2 

(may 

DC 

0 { 

be any sixteen bit value) 


DC 

0 ) 




i if the entry is 0, all memory used by the initialization subrou¬ 
tines is returned to the system after the subroutines have been 
executed (provided the subroutines have not caused the system to 
create data structures on their behalf). To retain a subroutine 
in memory, specify n, where n is the number of words to be 
retained. In this case, take care not to extend the memory 
requirement beyond that allocated to the bound unit's root when 
it was loaded. 
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LDBU 


DC <subn 

DC 0 

DC 0 


parameters to subroutine subn (may 
be any sixteen bit value) 


RESV $AF,0 


End of table sentinel 


subl 


sub2 


| subn 


Upon entrance to a subroutine, register B5 contains the 
return address. Before exit from the subroutine, register R1 
must contain the status. A value of zero indicates correct exe¬ 
cution. A nonzero value is the error code for this subroutine. 
If the status is non-zero, the following message is written to 
the error-out file, and a halt occurs. Execution of CLM cannot 
continue. 

134B INITIALIZATION SUBROUTINE ERROR 
(error code returned to register Rl) 
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MAP 


< 


MAP Directive 

Directive Name: MAP 

The MAP directive provides configuration information that 
enables you to verify the success of certain aspects of the 
system building process. The information presented by this 
directive includes the system physical attributes, system 
structures, device status, user-defined variables, and memory 
pool specifications. This information can be used to ease 
the debugging of system extensions and user-written device 
handlers. In addition, information (such as system symbols) 
is presented that would otherwise be unavailable. 

Format: 

MAP [path] [,map_form 1 ] [,map_form 2 ] ... 

| Argument Description: 

path 

Pathname of the file to which the map listing is to be 
written. The pathname cannot be that of a communications 
device. The pathname must be able to be verified when 
the CLM reads the MAP directive. 

If the pathname refers to a device file (e.g., 1LPT00), 
that device must have been configured when the MAP direc¬ 
tive is read. 

If the pathname refers to a disk file, the indicated 
volume must be mounted on the drive of a device that is 
already configured and recognized by the file system when 
the directive is read. If the pathname refers to a disk 
file that does not exist, the file will be created (as 
long as the directory structure identified in the path¬ 
name already exists). If the file already exists, it 
must be a variable sequential file. In this case, it 
will be opened in "renew" mode. 

The default map path value is >SID>CLM_MAP. 

( 
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MAP 


[map_form ) ]...[map_form n ] 

Any combination of the map format arguments described 
below can be entered in any order. If none of these 
arguments is specified, the entire system map is written 
to the map file. The complete map presents the following 
information (in the order shown): 

• System physical attributes 

• System structures 

• User-written device driver attributes 

• Device status for devices accessed by the file system 

• User-defined variables 

• Memory pool attributes 

• System extensions 

• User-selected permanently resident system overlays and 
system overlays made resident to serve as device 
drivers 

• System symbol table 

( -BRIEF ) 

,-BF | 

Requests display of only the physical attributes, system 
structures, user-written driver attributes, and user- 
selected permanently resident overlays. 

(-NDEV ) 
j~ND j 

Omits from the map the data pertaining to device status 
(devices accessed through the file system). 

i -NVAR ) 

r v j 

Omits from the map the data pertaining to user-defined 
variables. 

(-NPOOL I 

r p j 

Omits from the map the data pertaining to memory pools. 
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) -NRES \ 

\-m j 

Omits from the map the data pertaining to user-selected 
permanently resident system overlays and system overlays 
made resident to serve as device drivers. 

( -NSYM ) 

r s I 

Omits from the map the data pertaining to the system 
symbol table. 

Example 1: 

MAP -NS 

The system symbol table data is omitted from the map. The 
map is written to the map file whose pathname is 
>SID>CLM_MAP. 

Example 2: 

MAP !CONSOLE 

The entire map is produced and written to the console. The 
console output in this example is as follows: 
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MAP 


CLM MAP 


PHYSICAL ATTRIBUTES: 

GCUS6 MUD400-L2.1-03/28/1430 
SIP PRESENT 
NU CIP PRE SENT 
MMU PRESENT 

HIGH PHYSICAL MEMORY ADDRESS: 3FFFF 

HIGH VIRTUAL MEMORY ADDRESS: 6EDFF 

11 ME BETWEEN REALTIME CLOCK INTERRUPTS: 32 

OPERATOR CONSOLE. CONFIGURED 

ERROR MESSAGE LIBRARY IN USE 

SYSTEM STRUCTURES: (DECIMAL NUMERIC VALUES) 

45 IRHS, 3b ISAS, 10 SYSTEM OVERLAY AREAS, 

0 RECORD LOCKS CONFIGURED 

USER-WRITTEN DRIVERS: 

ZKI488 RELOCATIONS 5501 END= 5B80 ENTRY ADDRESS* 59DA 

LRN=20 LEVEL = 21 C HANNE L=E E 0 0 TCB AT 5BBb RCT AT 5DED 

STACK ALLOCATION SHEA 1(1 5DE A 

Z 1 U 4 8 8 RELOCATIONS 5FA0 END* 661F ENTRY ADDRESS* 6479 

LRN = 21 LE VE L*22 CMANNEL = COOO TCB AT 6655 RC T AT 670C 

STACK ALLOCATION 6689 TO 6709 

Z10488 RELOCATIONS 5EA0 END* 661F ENTRY ADDRESS* 6479 

L RN*2? LE VEL=22 CHANNE L=A000 ICB AT 6655 RCT AT 691C 

STACK ALLOCATION 690H TO 6919 


DEVICE STATUS: (1)1 VICES VISIBLE TO FILE SYSTEM) 



SYMPI) 


CHANNE L 

HE VICE 

VOLUME 

USAGE 

AVAILABLE 

.SEC TOPS 

VOLUME 

MEMBER 


NAME 



TYPE 

JD 


PHYSICAL 

LOGICAL 

SET NAME 

NUMBER 

b 

PCD 0 0 


laoo 

2332 

"CHECKL 

34 

0 

0 



B 

MSM01 


1800 

2361 

a 

f) 





13 

RCD01 


1480 

2332 

A 

1) 





H 

DSKOO 


0400 

2010 

* VL 6226 

1 

602 

602 



B 

DSKO t 


0480 

2010 

"CLM 

0 

164 

164 



B 

DSK02 


1200 

2010 

A 

0 





H 

DSK03 


1280 

2010 

"Pbl 

0 

1962 

1962 



H 

CONSOLE 

500 

201 A 

A 

2 





B 

CDPOO 


1300 

2008 

A 

l) 





B 

LPTOO 


1380 

2002 

A 

1 





USER-DEFINED CLM 

VARIABLES: 







A 

2 

5 

H - 

so 

c = 

600 

D = 6000 

fc = 

50000 


F 

= 

ssss 

J = 

FEEEEEFE 

K = 

EFEFEECE 

0 = 0 

P = 

12C 


0 

s 

0 

W = 

FFFFFCC8 

1 = 

EEFFED40 





MEMORY POOLS: 

SS START *9980 END=1OEFE SIZE* 7580 VIRTUAL BIAS* 0 
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ATTP1HU1ES= P USER'S PING NUMBER: 0 

AL SI AKT =20000 EN|) = 200FF SIZE: 100 VIRTUAL H1AS= F100 

ATTPIBUTfcS: tP USER'S WING NUMHt R = 1 

AK ST AKT =30000 ENI) = 3Q1FF SIZE: 200 VIPTUAL BIAS: 1F000 

ATTRIBUTES: tPCSU USER'S PING NUMBER: 2 
AH STAHT=00000 EN|)=6El)0F SIZE: 2EDE0 VIP1UAL H1A S = 2EE00 

ATTRIBUTES: PC USER'S PING NUMBER: 1 

AM STAPT=00000 ENI) = 0003E SI/C= 00 VIPIUAL BIAS= 2EE00 

ATTRIBUTES* CS USER'S RING NUMBER: 1 

AN 3TAPT=0<>000 END=0005F SIZE: 60 VIPTUAL BIAS: 2EE00 

ATTRIBUTES: PSU USEP'S RING NUMBER: 2 

LUHU'S: (SYSTEM EXTENSIONS) 

ZIUO 88 SIAPT: 5501 

Z10088 SIAPT: 5FA0 

ZXDEFM START: 701)8 

UVLYCT START: 7E F E 

VLOCO SIAPT: 8 3 3E 


RESOLA'S: (PERMANENTLY PESIOFNl EXECUTIVE OVERLAYS) 


01 X STAR|:0HRT) 

01 OCR SIAR|:S20H 
(IXPCL2 S1 AH I=917 0 
(IIO1M0 SIAPT = 89H A 
O0RUU2 S1 AH I:8 0ofc 
OYCRR SIAPT =8()00 
UZACCH SIAK1:8560 


01 DDK START=31l2 
UXPCL1 SI API:8E 66 
0 X G RI 2 STARl=87/7 
0I01M3 STARI=88A9 
UUERS2 ST ART =93 3 A 
OYIT SIART=8617 
UZXER START=96A0 


010LP S T API=53E 3 
0 IOI MS S T AH I:8AEB 
OXPCL-5 STAR 1:900 I 
OOB INI) STAR 1:8533 
OYASE SI AH I=9777 
0Z A VR2 SI AH T =90A 1 
OYCKPT S T AH I=8H02 


SYSTEM SYMBOL I ABIT : 


Z3EXEC 

LUCA I IONS 


ZIUSUH 

x 

tso 

ZXSTMX 

x 

1 1 6t 

ZXVLD 


1 1F2 

z iore m 

X 

1097 

/I A TON 

= 

1 1 ID 

ZMhSvu 

= 

BOO 

zmbspo 

s 

A Ft 

ZMRSVU 

= 

810 

/MNSPU 

z 

B 0 1 

ZMSWAP 

s 

A F if 

ZMRLOU 

s 

AFS 

ZMkLIN 

x 

AF8 

ZMHASl) 

x 

AFH 

zniAijp 

x 

1 1 37 

ZIOtRP 

s 

1 13B 

ZIOENf) 

s 

\ OS 

Z 1 UTRW 

r 

F OA 

ZMKOwN 

X 

B1F 

/XM(L X 

= 

11) A t 

zmssi; 

= 

IF 30 

ZXSPKU 

r 

1 B8F 

ZXSPI 


1 ( C H 

/ xcp 1 

z 

1 C C 8 

ZMACli 

z 

IK 3F 

ZXSE 1 P 

= 

iiati 

ZXC_SI 

z 

2 of s 

ZX1PSI 

z 

1 a Ah 

/ X R 1 S A 

s 

1 DCC 

ZXlwl 

z 

1 2 0 A 

ZXlS?K 

z 

012 

ZYOPF 3 

x 

2215 

ZYCLE 3 

z 

2220 

ZYFM 

z 

2 1 5 A 

ZYKOK 

r 

?. 11)6 

ZYSM 2 

z 

?13h 

ZYSM 

z 

2 1 6 A 

ZX1RML 

x 

1 F 0 A 

X X1) A 1 A 

z 

0 

XYCvS 

z 

9 AB 

XM_MGR 

s 

ABB 

XM_GET 

z 

H?B 

XM_W1 N 

z 

BC8 

XXCP l T 

x 

c?r. 

XXI PCT 

z 

C 7? 

xxmvcp 

z 

C90 

XX 1)1 All 

= 

ccf 

XXI RB 

x 

CF 2 

XXTSIK 

z 

D1 2 

XIO 

s 

l)AC 

XIUIMR 

s 

F 1 A 

XIOMGN 

X 

1 08E 

X1SPNS 

x 

1180 

XXWAIT 

s 

1 1F3 

XXOO 

X 

1267 

XXPOST 

7 

i 3F 3 

XXTEKM 

z 

14fcA 

XXSEM 

X 

1579 

XX1 PAP 

X 

168 A 

XUAMGP 

X 

1 7 Ah 

XULUAO 

X 

184F 

XUPOUT 

x 

1807 

XOVMGP 

X 

1 9BC 

XUfcWS 

X 

1B62 

XXPEU 

X 

1B 7 F 

XXSIO 

X 

1C49 

XXTSKK 

X 

1CA2 

XXSTSK 

s 

1D6B 

XXMCL 

X 

ID AH 

XXGRPR 

X 

IE 1 3 

XXAVP 

x 

If C3 

XXODU 

s 

11 D8 

XXTKML 

mt 

1F4A 

XXWCS 

2 

IF SC 

XXMBX 

s 

1F 61 

XXC.AI 

= 

1F76 
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MAP 


xxt_u 

s 

IF HO 

xxc_ci 

s 

1F 95 

XXC_IN 

X 

1FH 1 

XXC_KU 

s 

2034 

xxcmgr 

= 

20 8m 

XXFSW 

X 

2 1 OD 

XXMISC 

s 

2112 

XYEXT 

2 

2117 

X Y I N r 

X 

21C4 

XZLl.FN 

s 

2237 

XZM400 

2 

2F6F 

X/UVM4 

X 

3072 

XZSLCD 

,2 

2324 

XZVl 

X 

24 7C 

XZVLM4 

X 

24 AC 

XZXDEF 

2 

311H 

XYDML) 

X 

250E 

XYDMR1 

X 

252C 

XYDMS2 

X 

2571) 

XZOSUB 

2 

2650 

XZBF 

X 

2AA3 

X/RSUH 

X 

2763 

x/sm 

X 

2820 

XYSM 

X 

28FD 

XZBPAS 

X 

2CF7 

XZSMD 

X 

298t 

XZSliB 

X 

2D5H 

XZCONC 

2 

20AC 

X/GFDB 

2 

2t 7A 

XXGSPN 

X 

3118 

XXllPFO 

2 

31BC 

XXPTCH 

X 

329 A 

X I(JDK 

X 

31C2 

X X I N 1 T 

X 

34 7 A 

ZYXPA2 

X 

2201) 

ZICDR 

X 

081 

ZIDKI 

2 

OAC 

ZIEKLG 

2 

1108 

/ I K S R 

X 

081 

/ ILP1 

2 

DBl 

Z 1 0 A VR 

2 

1141 

Z JOCR 

X 

0 

L l UI)K 

2 

0 

ZIOERL 

X 

1139 

Z I 0 I N I 

X 

OH 1 

ZlULO 

X 

1 115 

ZiUTMO 

X 

111 F 

Z IUORG 

X 

112A 

ZX_PVC 

2 

1130 

ZIUSCH 

X 

1132 

ZIUASD 

X 

1133 

1 1OLP 

X 

0 

ZIOTRG 

2 

49 

ZiUTVC 

X 

E2H 

/1 (IXKtJ 

2 

65 

ZJO_AD 

2 

1135 

zio_sr 

X 

E 08 

ZIO_XA 

X 

1H 

Z I (ITER 

2 

l)E 9 

zn APF 

2 

0 

zn yp 

2 

1043 

Z11Y PR 

2 

1053 

zmge th 

X 

B30 

ZMGFIL 

X 

832 

ZMRTRN 

X 

BCC 

ZUALDC 

X 

1824 

ZOAKuC 

X 

18 39 

ZOLORT 

X 

191)9 

/ORELS 

X 

1AC5 

ZOHLDS 

2 

1A7C 

ZTVIUD 

2 

113t 

ZUtRS 

X 

1B6A 

ZXCNSH 

X 

1637 

ZXCNRU 

2 

1326 

ZXC_CR 

X 

20C 3 

ZXC_61 

2 

2099 

ZXC.RU 

2 

20 34 

Z X l> 0 

2 

1270 

Z XO_OP 

X 

1 2 AF 

ZXP_DH 

2 

12C4 

ZXOJ’P 

2 

12CE 

ZX0_PK 

2 

1 2fc A 

Z XD^RC 

X 

12F4 

/XD.fR 

X 

1529 

ZXD.1P 

2 

1529 

ZXECA 

2 

C2C 

ZXECA 

2 

C2C 

ZXGCM 

2 

389 

ZXISTR 

X 

1558 

ZXLMVE 

2 

C90 

ZXLPC 1 

2 

C 75 

ZXMCLT 

X 

1007 

/XPOS T 

X 

1 42F 

ZXKLU 

2 

1B 7F 

ZXSCH 

2 

1BF 

ZXSRCI 

X 

C 72 

ZXS*T 

X 

15C0 

zxuour 

2 

1L55 

ZXUPED 

X 

318C 

ZXVPS1 

2 

1598 

/ X W T 

2 

1213 

ZXXCA 

2 

C4E 

/XXCA 

X 

C4E 

/YDM2 

2 

2136 

ZYFM2 

2 

2155 

ZYUPF2 

X 

2212 

ZMDM01 

2 

C 18 

ZMDM02 

2 

C 18 

ZXDF1P 

2 

168F 

ZX1HEX 

2 

1776 

ZUDM01 

2 

IA2 

ZFKMIN 

2 

1A 

ZFRMRGl 

X 

70 

zfrmat 

2 

952 

FDEFS 









II1CH0 

2 

231 

JfcXGCB 

X 

1 CB 

SXSFTP 

2 

1 58 A 

JMOMO 1 

X 

A5A 

1>MDM02 

2 

A5D 




OVERLAYS 









(J I X 

X 

0 

010DK 

X 

1 

(IFMCR1 

2 

2 

01 OLP 

X 

3 

l) 1 OCR 

2 

4 

OIOTPE 

X 

5 

OXPCL1 

X 

6 

UIUIMS 

X 

7 

OXPCL 2 

2 

8 

U1UIM6 

X 

9 

OXCTSK 

2 

A 

OXBXFR 

2 

8 

OXGRI? 

X 

C 

OXLDVT 

2 

1) 

OlOIMS 

2 

F 

OXPCL 3 

X 

F 

oxpcbu 

2 

10 

OXOISK 

X 

1 1 

IIXCGKP 

2 

12 

nxsMCL 

X 

13 

OXOFRT 

2 

14 

0X0FP2 

X 

IS 

OXDFSP 

2 

16 

0XCGR1 

X 

17 

UXKWGP 

X 

18 

OXGRUS 

2 

19 

0XRQU2 

X 

1 A 

0XRUG3 

X 

18 

OXGR82 

2 

1C 

OXORT3 

2 

10 

(JXDTK1 

2 

IF 

OXGROT 

2 

IF 

OXOLGP 

X 

20 

OXCDRV 

T 

21 

OXACSP 

X 

22 

0101 MO 

2 

23 

0UEHS1 

2 

24 

OIOIMl 

X 

25 

UXC.XD 

2 

26 

0101*2 

X 

27 

UXC.1T 

2 

28 

010I M3 

2 

29 

0XSIO1 

X 

2A 

0/SI02 

S 

28 

0X3103 

X 

2C 

0XSIU4 

X 

20 

OXTRR 

s 

2E 

OXfcCSl 

s 

2F 

0XAVR1 

s 

30 

OIOIM4 

s 

31 

OXTRAP 

s 

32 

OXGACT 

s 

33 

OXTR17 

s 

34 

OXmATL 

2 

35 
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UXbSSP 

s 

36 

OXESftO 

2 

37 

0X1) GRP 

2 

38 

OXUPHI 

s 

39 

UXUPF1 

2 

3A 

OMS!AT 

2 

3B 

UUHIND 

s 

3C 

OIJMSCO 

2 

31) 

OOPACK 

2 

3E 

OORIKH 

2 

3F 

U0R0IJ2 

2 

ao 

UOCRUT 

2 

ai 

UUtHS? 

s 

a2 

0UERS3 

2 

a3 

0UFML2 

2 

aa 

UYASF 

s 

as 

UYCRF 

2 

a 6 

OYCRR 

2 

a 7 

UYDLF 

s 

a« 

UYLKF 

2 

a9 

OYMDF 

2 

aA 

OYULF 

s 

an 

UZALX 

2 

ac 

OZALX? 

2 

au 

UZCHF2 

2 

at 

□ / C R t 3 

2 

aF 

OZCRFa 

2 

so 

UZCRF5 

ss 

si 

UZCRR2 

2 

52 

UZLKOR 

2 

S3 

UZULDR 

2 

sa 

DYGIF 

2 

ss 

IJYGTF 

2 

56 

OYPLFN 

r 

S 7 

OYRMF 

2 

SB 

OZGIF? 

2 

59 

UZG1F3 

r 

5A 

UZlODH 

2 

SH 

OZCFDH 

2 

SC 

UZGFCb 

2 

SI) 

UZGfRF 

2 

SE 

OYUPN 

2 

SF 

O/UPFI) 

2 

60 

OZOPFF 

2 

61 

OZOPFU 

2 

62 

UYCLS 

r 

63 

UZCLtD 

2 

na 

UY ACL 

2 

65 

0/ACL P 

2 

66 

OYAVR 

2 

67 

OYCMR 

2 

68 

1.1 Y 1 I 

2 

69 

UYSWP 

2 

6 A 

0ZAVR2 

2 

6B 

UZAVK3 

2 

6C 

(JZVMT 

2 

6 D 

UZVMTZ 

2 

6E 

UZVMI3 

2 

6F 

UYCttD 

2 

7 0 

OYXPA 

2 

7 1 

OYST I Y 

2 

72 

l) Y i% T F L 

2 

73 

OZSME 

2 

74 

fJZSMt 1 

2 

7S 

UZSMt2 

2 

76 

OZSMf 

2 

77 

UYHPCK 

2 

78 

UYGIBP 

2 

79 

UZHF 2 

2 

7 A 

OYDMPZ 

= 

7 H 

l)Yl)MR3 

2 

7 C 

IJ/DMR 

2 

71) 

0YDMS1 

2 

7t 

0YUPS2 

2 

7F 

OZDMSP 

2 

80 

U/ACCH 

2 

81 

O/UCCB 

2 

8? 

OZIJSUH 

2 

83 

U Y DM I1 

= 

8a 

f)YDMI2 

2 

MS 

OY UP l 1 

2 

86 

UZ1UPF 

= 

87 

11/lPvSN 

2 

MB 

OYDMC 

2 

89 

It/CtK 

2 

8 A 

U/C INV 

2 

MB 

OZCKLY 

2 

8C 

UZCLNK 

2 

HD 

U/CUPF 

2 

HE 

(JZCPSN 

2 

8F 

ll/CSUH 

2 

90 

U/DMC 

2 

91 

OYDMX1 

2 

92 

ItZDMX 

s 

9* 

UZXtNT 

2 

9a 

OZXFR 

2 

95 

UZXLVl 

2 

96 

UZ XPSN 

2 

97 

OZXSPL 

2 

98 

(IZXSUB 

r 

99 

UYDMX2 

2 

9 A 

UYDM! 

2 

9B 

UZDM 

2 

9C 

UZTCLE 

2 

9D 

U/TtHC 

2 

9E 

OZH XI) 

2 

9F 

UZTUP1 

2 

AO 

OZI0P2 

2 

Al 

OZ HIP 3 

r 

A2 

nzTUPa 

2 

A3 

0/1PSN 

2 

Aa 

UZ1SUH 

= 

AS 

UZIUTL 

2 

A 6 

OYCKPT 

2 

A 7 

IIZCKPT 

2 

A 8 

UYRSRl 

2 

A9 

UYUREC 

2 

AA 

LlZBEF 

2 

AB 

UZBIIR 

2 

AC 

0ZB10R 

2 

AD 

OZHIwH 

2 

AE 

OZCLPT 

2 

AF 

UZROLB 

2 

BO 

IIXMHC 1 

= 

HI 

IJXMHC? 

2 

H2 

0XMBC3 

2 

83 

LIXMHf. 4 

2 

na 

OXMHCS 

2 

8 S 

IIXMBA1 

2 

B6 

UXMHA2 

2 

H 7 

UXMBA3 

2 

H8 

UXMHi1 

2 

B9 

(IXMH l 2 

s 

HA 

UXMHS1 

2 

88 

IIXMHSZ 

2 

BC 

UXMHS3 

2 

HI) 

UXMHR1 

2 

HE 

UXMBR2 

5 

BF 

UXMHR 3 

2 

CO 

DXMHRa 

2 

Cl 

(IXMBi)l 


C 2 

UXMH 1 l 

2 

C 3 

0XMHI2 

2 

ca 

(IXMH 13 

2 

CS 

(IXMH 1 a 

s 

Cb 

UXFLG1 

2 

C 7 

UXELG? 

2 

Ctt 

IJXCKPT 

2 

c: 9 

OXEKPl 

2 

CA 

IJXCKPT 

2 

CB 

UXCKPA 

= 

cc 

UXCPA2 

2 

CD 

UXRS I 

2 

CE 

UXKS10 

= 

CF 

UXRST1 

2 

DO 

UXRST? 

2 

D1 

OXKS 1 3 

2 

\)2 

OXRSTF 

2 

D3 

OXRSER 

2 

oa 

oxhsip 


OS 

UXCKPO 

= 

D6 




ZIO«HH 









LUCA 1 IUNS 









ZIU488 

2 

SS1H 

ziuaBH 

2 

SS1H 

ZJUaBA 

2 

5621 

ZI048I 

2 

S9DA 
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L 10488 

LUCA I IUNS 

/IU488 = SFrtA ZIU488 = SFHA /J U48A = 60C0 

Z1U481 = 6<j79 


ZXDEFM 

LUCA 1 IONS 

/ X I N I r = 7FCO 


UVLVCT 

LUCA I I (JNS 

TAbl = 7F1H r AU2 = 80 1 C TAHi = 8110 

I A H 4 = 82 IE 


VLOCt) 
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MEMPOOL DIRECTIVE 


Directive Name: MEMPOOL 

A MEMPOOL directive defines a system memory pool, a batch 
memory pool, an exclusive online memory pool, or a non¬ 
exclusive online memory pool. Each MEMPOOL directive 
describes only one type of memory pool, but a single MEMPOOL 
directive may describe more than one exclusive online memory 
pool or more than one nonexclusive online memory pool. (You 
have the option of expressing the size of a memory pool sym¬ 
bolically by defining the size in a VARIABLE directive. See 
the description of the VARIABLE directive elsewhere in this 
section.) 

Format 1: 

MEMPOOL 

Format 2: 

MEMPOOL 


Format 3: 

MEMPOOL 


Argument Descr 
S 

The letter S designates a system memory pool. The system 
memory pool must be defined in a separate MEMPOOL direc¬ 
tive. If multiple MEMPOOL directives have S as the first 
argument, only the last one is used. 

size 

The size argument is a positive integer that defines the 
number of words requested for the memory pool. To 
specify a pool size greater than 65535io words, use the 
double-word hexadecimal integer format (e.g., D'lOAOO'). 


S,,size [,P] 



iption Format 1 
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The size of the system pool may also be specified by an 
asterisk (*), in which case CLM will allocate to the system pool 
all memory remaining after MEMPOOL directives specifying explicit 
sizes have been processed. Only one pool may be defined with "*" 
in its size field. Once any pool has been defined this way, no 
other pool may be so defined. 

If a system memory pool is not defined in an explicit MEMPOOL 
directive, its size is set at 3K (3072) words. 

The size of pools must be in multiples of a certain number of 
words and will be rounded to the next highest multiple by CLM. 

For pools that are neither protected nor contained, the size of 
the increment is 32 words. For pools that are protected or con¬ 
tained the size of the increment depends on the Level 6 system in 
which they are to be used as shown in Table 5-3. If a pool that 
is protected or contained has the potential of extending into the 
batch pool, the increment for the batch pool must comply with 
that of the extendable pool. 


Table 5-3. Increments for Memory Pools 


System 3 

Increment 

(Words) 

LAF 


(with 1024K memory) 

LAF 

64K 

(with less than 1024K memory) 
SAF 

256 

(with 64K memory) 

SAF 

4K 

(with less than 64K memory) 

256 

a Memory pool protection/containment requires 

that the Level 6 central processor possess a 
memory management unit. 


Suggestions for calculating the sizes of memory pools are given 
after the functional description of the MEMPOOL directive. 

P 

The letter P specifies that the pool is protected; i.e., 
users of other non-overlapping memory pools are prevented 
from writing into it. If the argument is omitted the 
pool is not protected. If the pool being protected is 
the system pool, the executive code and the system data 
structures are protected along with the system pool. If 
the system being configured does not have the MMU, this 
option is not effective, and a warning diagnostic is 
issued. 
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Argument Description Format 2: 
B 


The letter B designates a batch memory pool. A batch 
memory pool can be specified only once, in a separate 
MEMPOOL directive. If two or more MEMPOOL directives 
have B as a first argument, an error occurs. 

size 

Same as for Format 1. 


Same as for Format 1. 


c J 

The letter C specifies that the pool is contained; i.e., 
users of the pool are prevented from writing outside of 
it. The letters NC specify that the pool is not con¬ 
tained. The default for batch is contained. If the 
system being configured does not have an MMU, no pool may 
be contained and non-containment is the default. 


Argument Description Format 3: 

E 

null 

E indicates an exclusive (nonoverlapping) online memory 
pool. A MEMPOOL directive that has E as its first argu¬ 
ment defines one or more exclusive online memory pools. 
Even if your MEMPOOL directive defines more than one 
exclusive online memory pool, you need to specify E only 
once (as the first argument). See Example 5. All exclu¬ 
sive online memory pools defined in all MEMPOOL direc¬ 
tives with E as their first argument constitute a pool 
set. 


A null (no entry) first argument indicates a nonexclusive 
(potentially overlapping) online memory pool. A MEMPOOL 
directive with a null first argument defines one or more 
nonexclusive online memory pools. 

Each of these pool sets is an alternative definition of 
the same physical area of memory. All pools defined by a 
single MEMPOOL directive must be either exclusive or 
nonexclusive. 
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pool_name 

The 2-character ASCII name that uniquely identifies each 
exclusive and nonexclusive online memory pool. The pool 
name is used in CG (create group) and SG (spawn group) 
commands and in $CRGRP and $SPGRP macro calls. 

If the pool_name begins with a decimal digit, the pool_ 
name argument must be surrounded by apostrophes (e.g., 

'1A') . 


A pool_name argument should not be included in a MEMPOOL 
directive for a system memory pool or a batch memory 
pool. The omission of the pool_name argument in these 
cases must be signified by a comma. 

NOTE: At login you can (1) specify the two character 

identification of the memory pool, or (2) specify 
a single character and accept the second character 
assigned by the facility, or (3) omit the pool 
identification and accept a two-character identi¬ 
fication whose first character is L. 

If you login by method (2), all online memory 
pools to be used by the login facility must have 
the same first character in their pool name argu¬ 
ments. This shared first character should not be 
assigned to any other mefnory pool. In addition, 
it is advisable to assign second characters 
starting with digits 0 through 9 (in order), then 
letters A through Z (in order); this practice will 
optimize the efficiency of the algorithm used by 
the system's logic facility when it searches for 
an available memory pool. 

You can login by method (3) in the same way as for 
(2) except that the first character must be L. 

If you login by methods (2) or (3), you should 
define at least as many memory pools as the number 
of users who may concurrently gain access to the 
system. 


5-46 


CB 23-03 



size 


The description of the size argument for Format 1 also 
applies to Format 3. If an asterisk is not used to 
define the size of the system pool, it may be used to 
define the size of an exclusive or a nonexclusive online 
memory pool. In this case the pool size is calculated by 
CLM. CLM will allocate to this pool all memory remaining 
after MEMPOOLs with explicit sizes have been processed. 
Once the size of an exclusive pool has been defined with 
an asterisk, no subsequent pool may have its size defined 
by an asterisk. Once the size of a nonexclusive pool has 
been defined with an asterisk, no more pools may be 
defined on that directive line. A subsequent pool direc¬ 
tive may define the size of a nonexclusive pool with an 
asterisk if the pool is the last pool defined by that 
directive. The size of an exclusive pool may not be 
defined with an asterisk if the size of a nonexclusive 
pool has been defined with an asterisk. 

pool_namel 

This option allows the user to refer to a given pool by 
two (or more) names. pool namel is the name of a pool 
specified by a previous MEMPOOL directive; pool_name is 
the new name. The attributes of the pool are specified 
by the original directive and cannot be changed by sub¬ 
sequent directives that use this option. 


[X] 

The letter X indicates that the online pool can be 
extended into the batch pool area. If a memory request 
cannot be satisfied within the defined size of the online 
pool, the contents of the batch pool are rolled out of 
memory. If X is omitted, the online pgol is not 
extendable. If the contents of the batch pool are to be 
rolled out of memory upon a SSPB (suspend batch) operator 
command, at least one online memory pool must be defined 
with an X argument. 

[U] 

The letter U specifies that groups using this pool run in 
the unprivileged mode. Groups running in the unprivi¬ 
leged mode may not execute privileged instructions and 
will trap if a privileged instruction is attempted. The 
default is privileged. 

[P] 


Same as for Format 1. 
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[C] 

Same as for Format 2, except that for pools defined by 
Format 3 the default is not contained . 

[* 3 ] 

The letter S specifies serial usage of the pool; i.e., 
only one group at a time can use it. An attempt to 
create a second group using a serial usage pool results 
in an error return and the second group is not created. 

If this argument is omitted, the pool can be used by more 
than one group at a time. 

Functional Description: 

Each MEMPOOL directive causes a pool descriptor list to be 
created. Later, after the memory requirements of the system 
and its extensions are known, each pool set is checked to 
ascertain whether it can fit into the remaining available 
space. If any element or pool set is too large, an error 
occurs. 

The Configuration Load Manager creates a file named ROLLOUT 
under the SID directory of the bootstrap volume if a batch 
memory pool is defined and at least one online memory pool 
definition includes an X argument. If a ROLLOUT file is to 
be created on a bootstrap diskette , it is usually necessary 
to delete unneeded elements from the bootstrap diskette 
(~ZSYS00) and then copy the remaining contents of this 
diskette to a backup volume (where the remaining contents 
will be consolidated into a consecutive area). This tech¬ 
nique will provide the largest possible consecutive area of 
unused space on the backup volume. Using this backup volume 
as the bootstrap volume, you can optimize the possibility of 
successful creation of a ROLLOUT file large enough to accom¬ 
modate the batch memory pool. 

The following discussion of the protect and contain attri¬ 
butes applies only to a system having an MMU. The system 
pool may be protected or not. It may not be contained. The 
batch pool may be contained or not. It may be protected or 
not; but if it is protected, it will be protected only from 
those pools that have no potential for extending into the 
batch pool. 

All other exclusive nonextendable pools may be protected, or 
contained, or protected and contained, or neither protected 
nor contained. An exclusive pool that is extendable may also 
be contained. However, when such a pool is defined, the 
system does not prevent the user from accidentally writing 
into the batch pool area before the batch program is rolled 
out. 
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An exclusive pool that is extendable may also be protected. 

If such a pool extends into the batch pool area, the part in 
the batch area is protected only if there are no other 
extendable pools. 

The protect and contain attributes apply to all nonexclusive 
pools collectively. If any nonexclusive pool is protected or 
contained, then the set of nonexclusive pools have the same 
attribute(s). Nonexclusive pools may not be individually 
contained or protected from each other. A protected non¬ 
exclusive pool, therefore, is protected from exclusive pools 
or from the batch pool overwriting its space. It is not pro¬ 
tected from other nonexclusive pools overwriting its space. 


Guidelines for Calculating System Pool Memory Size: 

The following tables provide guidance in calculating the size 
of the system memory pool. 

Table 5-4 lists the number of words of resident code required 
for various system components; Table 5-4 also lists the number of 
sharable and/or exclusive files that are used. 

Table 5-5 lists formulas that can be used to calculate file 
memory space. 

Table 5-6 describes memory requirements for various system 
control structures. 

Table 5-7 describes memory requirements for elements in 
online or batch memory pools. 

Table 5-8 describes memory requirements for the Message 
Facility and Checkpoint/Restart (described in the System 
Concepts manual). 

The user is advised that the system memory pool must be large 
enough to handle the "worst case" situation. To compensate for 
pool fragmentation, increase the total pool size by at least 10 
percent. The pool size must be a multiple of 32 words. 
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Table 5-4 


Resident Code Required for System Components 


All system components not listed below (and not also the subject 
of a separate release bulletin) are less than 200 words. 

Component 

Resident 

Code 

Sharable Files 

Exclusive Files 

Access Control 
Utilities 




Delete Access 
Control 

1,080 



Delete Common 
Access Control 

1,080 



List Access 
Control 

1,545 



List Common 
Access Control 

1,545 



Set Access 
Control 

1,180 



Set Common 
Access Control 

1,180 



BU_CONVERT 

4,969 

Input file 

Output file 

Check Mass 
Storage Volume 

7,273 



Compare 

4,986 

Input file 

Output file 


Compare ASCII 

2,616 

Input file 

Output file 


Copy 

6,856 

Input file 

Output file 

Commercial 

Instruction 

Simulator 

4,500 



Create 

Directory 

380 



Create File 

1,280 



Create Index 

1,120 



Create Mailbox 

1,611 
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Table 5 4 (cont). Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable Files 

Exclusive Files 

Create Volume 

10,634 

Output files 
(MDUMP etc.) 

Output volume 

Data Exchange 
Utilities 




Compare Data 
Exchange 

3,936 


Input file 
Output file 

Copy Data 
Exchange 

3,945 


Input file 

Output file 

Create Volume 
Data Exchange 

1,500 


Output file 

File Change 

Data Exchange 

1,286 


Input file 

File Dump Data 
Exchange 

1,536 


Input file 

List Data 
Exchange 

3,284 


Input file 

Output file 

Debug ($D) 

2,270 


Work file 

Debug 

(Multi-User) 

1,400 
(system 
pool) 


Work file(s) 


1,500 

(user pool) 



Quick Break¬ 
point 

Processing 

3,750 
(system 
pool) + 
user- 
specified 
size of 
quick memory 
buffers 



Deferred Print/ 
Punch 

1,055 

Input file 


Delete 

Directory 

790 



Delete File 

820 
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Table 5-4 (cont). Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable Files 

Exclusive Files 

Delete Index 

845 



Display 

Formatting 




Create 

Print 

VDAM 

VFORMS command 

4,140 

1,406 

7,663 

592 

FORMS>VDAM_FORM 01 


DPEDIT 

SAF 7,345 
LAF 7,748 

Input file 

Output file 


Editor 

7,111 

(+ 2KW per 
user) 


Input file 

Output file 
Temporary work 
files (CI=128) 

Export 

2,300 

Input files 

Output files 

* 

File Change 

1,354 


Input file 

File Dump 

1,625 
(+ 300W/ 
user) 

Input file 

Output file 


Get File 

735 



Get Quota 

5,700 



Interactive 

System 

Definition 
(M4_S YSDEF) 

4,777 

(+ 4KW Get 
Memory) 


Output file 

Linker 

10,750 
(+ default 
Get Memory 
of 2KW) 

Input files 

Output files 

List Creation 
Date 

2,990 

Input file 


List Names 

4,982 

Input file 

Output file 


List Tape 
Contents 

1,417 

Output file 

Input file 
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Table 5-4 (cont). Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable Files 

Exclusive Files 

Listener 

2,231 

Input file 


Load Index 

1,885 

Output file 


Modify File 

1,030 



Patch 

10,299 

Input file 

Output file 


Prime Index 

5,790 

Output file 


Print 

1,507 

Input file 


Print/Punch 

Daemon 

6,800 

Input file 

Output file 


Queue Report 

1,772 

Input file 

Output file 

Rename 

1,025 



Report Queue 
Maintenance 

3,000 


Input file 

Output file 

Restore 

3,800 

(+2.5K 

Get 

Memory) 


Input file 

Output file 
+ 1 temporary 
work file 

Reorganize 
Indexed File 

2,020 

Input file 

Work file 


Save 

2,525 

(+2.3K 

Ge t 

Memory) 

Input file 

Output file 
+ 1 temporary 
work file 

Set Terminal 
Character¬ 
istics 

2,135 


> * 

SIP Simulator 
(Double) 

2,000 



SIP Simulator 
(S i ng 1 e) 

600 



Tape 

Positioning 

610 


Input file 
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Table 5-4 (cont) Resident Code Required for System Components 


Component 

Resident 

Code 

Sharable Files 

Exclusive Files 

TCLC 

2,900 



TCLP 

See Note 



Unspool 

5,700 

Input files 


Walk Subtree 

800 



ZXDEFM 
(Defective 
Memory Trap 
Handler) 

300 



ZXPFR 

(Power 

Resumption 

Facility) 

262 




NOTE: The actual number of words required by the TCLP to perform 

transaction processing depends on the number of concurrent 
users and the mix of transactions they are running. Refer 
to Appendix F in the Transaction Control Language Facility 
manual for the formulas used to calculate the TCLP memory 
requirements. 


Table 5-5. Formulas for Calculating File Memory Space 


Memory Requirements in a MOD 400 LAF System 

_L 

File Reserved 
Exclusively 

Memory Required for 
System Memory Pool 
(in words) 

96 + (M x 32) where M is 
the number of buffers 

Memory Required for 
Online (User) Memory 
Pool (in words) 

64 + (M x Cl size) 

2 

where M is the number of 
buffers 

ShaTable F 1 1 6 S 

: 

Memory Required for 
System Memory Pool 
(in words) 

96 + M(32 + Cl size) 

2 

where M is the number of 
buffers 

Memory Required for 
Online (User) Memory 
Pool (in words) 

64 
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Table 5-5 (cont) . Formulas for Calculating File Memory Space 


Memory Requirements in a MOD 400 SAF System 


File Reserved 
Exclusively 

Memory Required for 
System Memory Pool 
(in words) 

64 + (M x 32) where M is 
the number of buffers 

Memory Required for 
Online (User) Memory 
Pool (in words) 

32 + (Mx Cl size) 

2 

where M is the number of 
buffers 

Sharable Files 

Memory Required for 
System Memory Pool 
(in words) 

64 + M(32 + Cl size) 

2 

where M is the number of 
buffers 

Memory Required for 
Online (User) Memory 
Pool (in words) 

32 


Cl size = control interval size 


NOTE: For all system commands, the number of buffers per file 

is one (unless the user has acted to change this value). 

The control interval size for each command is 512 
(unless the user has allocated a file with a different 
control interval size). 


Table 5-6. Memory Requirements for System Control Structures 


Element 

Word Size 

Occurrences 

Product 

SAF LAF 

The number and size of the various control structures will vary 
depending on the installation's processing requirements. For 
each item in the "Element" column multiply the word size (using 
the SAF or LAF figure, as appropriate) by the number of esti¬ 
mated occurrences to obtain a "Product"; then add all the 
products. 

Batch GCB (includes LFT, LRT) 
for LFN+LRN < 47 (SAF) 
and LFN+LRN <28 (LAF) 

For every LFN+LRN above 
these limits, add 1 (SAF) 
or 2 (LAF) words. 

96 128 

0 or 1 
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Table 5-6 (cont). Memory Requirements for System 

Control Structures 



Word Size 

Occ urrences 

Product 

Element 

SAF 

LAF 

Batch TCB's (includes lead 
task, execution commands) 
Without SIP 

With SIP 

64 

96 

96 

128 

n . . . 


Batch Request Blocks 

64 

96 

n 


Rollout Capability 
(Rollout File and Code) 

367 

447 

0 or 1 


Each Active Disk Directory 
and File (include bound 
units as files) 

64 

96 

n 


Per Command Input/User Input 
File 

Operator Terminal (MDC) 

Disk 3 

TTY (MLCP) 

PRU, CR 

32 

160 

64 

96 

32 

160 

64 

96 

n 

n 

n 

n 


Per User Disk File With 

Concurrency of "Sharable" 
or Per "Device File" b 
Management (buffer size) 

Disk 3 

PR, PRU 

CR, KSR 

CI+32 

96 

64 

CI+32 

96 

64 

n 

n 


Per Active File 3 

(buffer control block) 

32 

32 

n 


Per Bound Unit 

(File overhead - sharable 
or overlays) 

128 

192 

n 


Per Sharable Bound Unit 

SB US (SAF) = 18 + 

5(number of overlays) + 

4(number of EDEFed symbols) 

+ code size 

p n i ip 

OD UO 


C i inn r\ f 
u uiu v/ j- 

SBUS's 


Tape Volume Name Block 

32 

32 

n 


Concurrently Outstanding 

Mount Volume Requests 

32 

32 

n 
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Table 5-6 (cont). Memory Requirements for System 

Control Structures 



Word 

Size 



Element 

SAF 

LAF 

Occ urrences 

Product 

Expanded Trap Save Areas 
for Each Task 

128 

192 

n 


System Overhead 

Total Pool Size Without 
Fragmentation (sum of 
Product column) 

•« 

Fragmentation Allowance 
(10 percent of item 
immediately above) 

1504 

i 

1856 

i 

i 



Legend: 


GCB - Group control block 
LFT - Logical file table 
LRT - Logical resource table 
TCB - Task control block 
SIP - Scientific Instruction Processor 
Cl - Disk control interval 

a Indexed sequential files must be counted as two 

b Double the word size value if the "device file" 
and buffered. 


files. 

is bidirectional 


Guidelines for Calculating Online and Batch Memory Pool Size 


of 


The following table 
the online pools and 


provides guidance 
the batch pool. 


in calculating 


the size 
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Table 5-7. Memory Requirements for Elements in Online or 
Batch Memory Pools 



Word 

Si ze 



Element 

SAF 

LAF 

Occ urrences 

Product 






The number and size of various elements will vary depending on 

the installation's processing 

requirements. 

For each item in 

the "Elements" column, multiply the 

word size (using the 

SAF or 

1 LAF figure, as appropriate) by the number of estimated occur- 

rences to obtain a "Product"; 

then add all 

the products. 


GCB (includes LFT, LRT) a 

96 

128 

n 


for LFN+LRN <47 (SAF) 
and LFN + LRN <28 (LAF) 





For every LFN+LRN above 





these limits, add 1 (SAF) 
or 2 (LAF) words. 





TCB's (includes lead task and 





execution commands) 3 

Without SIP 

64 

96 

n 


With SIP 

96 

128 

n 


GROUP REQUEST BLOCKS 3 

64 

96 

n 


Work Space for Commands 





Execution Commands 

192 

192 

n 


Commands From Interactive 

32 

32 

n 


Terminal 





TRB (exclude lead task. 

64 

96 

n 


include execution 
commands) 





Per Command Input/User Input 





File - ” 

Dev ice 

32 

64 

n 


Disk/Tape 

64 

64 



Per Error Out/User Out File 





Nondisk 

64 

64 

n 


Di sk 

224 

224 

n 


Per User File (FCB) 

32 

64 

n 


Per User Disk File With 

CI+32 

CI+32 

n 


Concurrency of "Exclusive" 
Under Control of Data 
Management 6 (buffer size) 





Per Associate File 

32 

32 

n 
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Table 5-7 (cont) 


Memory Requirements for Elements in Online 
or Batch Memory Pools 



Word 

Si ze 


Elements 

SAF 

LAF 

Occurrences 

Per User File Under Control 
of Storage Management 

32 

32 

n 

Per Nonsharable Bound Unit 
NSBUS (SAF) = 18 + 

5(number of overlays) + 

4(number of EDEFed symbols) 

+ code size 

NSBUS 


Sum of 
NSBUS's 

Per Nonsharable Bound 

Unit (cont) 

NSBUS (LAF) = 25 + 

6(number of overlays) + 

5(number of EDEFed symbols) 

+ code size 


NSBUS 

Sum of 
NSBUS's 

Any Bound Unit With Slow 

Load Section 

160 

160 

0 or 1 

User Requested Memory 



n 

Total Pool Size Without 
Fragmentation (sum of 

Product column) 




Fragmentation Allowance 
(10 percent of item 
immediately above) 





Legend: 


GCB - Group control block 
LFT - Logical file table 
LRT - Logical resource table 
TCB - Task control block 
SIP - Scientific Instruction Processor 
TRB - Task request block 
FCB - File control block 
Cl - Disk control interval 

’When calculating the size of the batch memory pool, do not 
include this item since, in the case of batch processing, it 
appears in the system memory pool (see Table 5-6). 

b Indexed sequential files must be counted as two files. 


MEMPOOL 















MEMPOOL 


Table 5-8. Memory Requirements for Message Facility and 
Checkpoint/Restart 


Component 

User 

Pool 

System 

Pool 

Occ urrences 

Message Facility 




System overhead 


192 

1 

For each task group using 
Message Facility 

64 


n 

For each mailbox 

160 

128 

n 

For each mailbox with 
disk queuing 


128 

n 

Checkpoint/Restart 




Permanently allocated 
(for each group using 
Checkpoint/Restart) 

320 

256 

n 

Dynamically used during 
every Checkpoint (For 
more than 2 tasks in 
the group, add 192 for 
each additional task) 

576 


n 

Dynamically used during 
every Restart 


480 

n 


Example 1: 

MEMPOOL S, f 4096 

In this example, a system memory pool of 4096 words is 
defined. Because a system memory pool is being defined, no 
pool name argument is specified, but the second comma indi¬ 
cates” omission of the argument. 

Example 2: 

MEMPOOL B,,12288 

In this example, a batch memory pool of 12,288 words is 
defined. Because a batch memory pool is being defined, no 
pool_name argument is specified, but the second comma indi¬ 
cates omission of the argument. The batch pool is implicitly 
contained unless the pool size is followed by ",NC", which 
specifies not contained. 
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Example 3: 

tf MEMPOOL E,AB, 12768,,CD,1024, X 

V MEMPOOL E,EF,2048 

In this example, three exclusive online memory pools are 
defined. The three pools constitute the set of exclusive 
online memory pools. The first MEMPOOL directive defines two 
exclusive online memory pools: (1) The first, whose pool 

name is AB, comprises 12,768 words; it cannot dynamically 
extend into the batch memory pool because argument 4 of the 
MEMPOOL directive is null. (2) The second, whose pool name 
is CD, comprises 1024 word§; it can dynamically extend (if 
necessary) into the batch memory pool because argument 7 is 
X, indicating rollout. The second MEMPOOL directive defines 
an exclusive online memory pool named EF. This memory pool 
comprises 2048 words. It cannot dynamically extend into the 
batch memory pool because argument 4 is null. 

Example 4: 

MEMPOOL ,XY,512,,UV,* 

MEMPOOL ,WX,*,X 

In this example, three nonexclusive online memory pools are 
defined (argument 1 in each MEMPOOL directive is null). Each 
MEMPOOL directive defines a pool set; the first pool set 

t comprises two pools, the second pool set comprises one pool. 

Because two pool sets are nonexclusive, they define the same 
physical area of memory (i.e., they overlap). Any contention 
for space within this area of memory will be resolved by the 
system. 

The first MEMPOOL directive defines two nonexclusive online 
memory pools: (1) The first, whose pool name is XY, com¬ 

prises 512 words; it cannot dynamically extend into the batch 
memory pool because argument 4 of the MEMPOOL directive is 
null. (2) The second, whose pool name ib UV, occupies all 
memory remaining after the pools with explicit sizes have 
been allocated (because argument 6 is an asterisk); pool UV 
cannot dynamically extend into the batch memory pool because 
argument 7 is null. The second MEMPOOL directive defines a 
nonexclusive online memory pool area named WX. It can 
dynamically extend (if necessary) into the 6atch memory pool 
(argument 4 is X, indicating rollout). 

The diagram below (not drawn to scale) indicates the memory 
pools established by the MEMPOOL directives in examples 1 
through 4. Note that the two sets of nonexclusive online 
memory pools define the same physical area of memory. 


( 
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MEMPOOL 


OPERATING 

SYSTEM 


HIGH 

MEMORY 




| 


^ ir _ - 



^ v 

SYSTEM MEMORY 
POOL 

POOLAB POOL CD POOL EF 

EXCLUSIVE POOL 

AREA 

J>OOL XY POOL UV, 

POOL WX 

NONEXCLUSIVE POOL 
AREA 

BATCH MEMORY 
POOL 





Example 5: 


MEMPOOL E,JJ,4096,PCUSX,RR,8000,SU 

This example defines two memory pools; one named JJ, the 
other RR. Both pools are exclusive. The attributes for pool 
JJ are designated by the two arguments that follow the entry 
JJ. The first designates a size of 4096 words. The second 
specifies that the pool is protected, contained, and unprivi- 
ledged, that only one group can use it at a time (serial 
usage), and that it can extend into the batch pool area. 

Note that the elements of this argument can be entered in any 
order, and that no commas are inserted between elements. 

Pool RR is assigned 8000 words of memory. It is neither pro¬ 
tected, nor contained, nor expandable; it is unpriviledged 
and requires serial usage. 

Example 6: 


MEMPOOL E,KK,4000,PS 


MEMPOOL E,LL,KK,,MM,KK 

This example illustrates the use of the renames option. 

Pool KK is declared first. The second directive specifies 
alternate names for this pool. Pools LL and MM have the same 
attributes as KK. Both are protected since KK is protected. 
All three names define the same 4000-word area in memory. 
Since KK is serial usage, LL and MM are serial usage also. 

The serial usage attribute is a function of the pool name. 
Since these three pool names describe the same memory pool, 
three groups can possibly use the pool area concurrently. A 
group using pool KK, a group using a pool LL, and a group 
using MM could all be active at the same time. But, for 
example, two groups using the pool name KK could not both be 
active at the same time. 
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QUIT 


QUIT DIRECTIVE 


Directive Name: QUIT 

The QUIT directive must be the last directive in the file of 
CLM directives. 

Format: 


QUIT [VER] 


Argument Description: 

[VER] 

The VER argument causes the version (date and time cre¬ 
ated) of each Configuration Load Manager module used to 
be typed out at the operator terminal. The format of the 
typeout is shown below under the example. 

Functional Description: 

The QUIT directive causes the Configuration Load Manager to 

cease reading CLM directives and to begin its loading phase. 

The following actions occur: 

1. Any required final data structures are created. 

2. If a communications environment has been defined, it is 
initialized. 

3. Bound units (if any) identified in LDBU directives are 
loaded into the system area of memory. 

4. System overlays (if any) identified in RESOLA directives 
are loaded into the system area of memory. 

5. Memory pool descriptors are created, based on the con¬ 
tents of MEMPOOL directives. Each memory pool set is 
checked to ascertain whether it can fit into available 
memory space. 

6. The Configuration Load Manager terminates. 
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Example : 


QUIT VER 





This example causes the Configuration Load Manager to cease 
reading CLM directives, type out the version identifier of 
each CLM module used, and enter its loading phase. The 
typeout might appear as shown below. 

($S) CLMVAR 80/10/03/0836 
($S) CLMST1 80/09/14/0903 
($S) CLMST2 80/10/02/0808 
($S) CLMDEV 80/10/10/1206 
($S) CLMMMU 80/08/17/1021 
($S) CLMC0M 80/11/08/1530 
($S) CLMCM2 80/10/15/2105 
($S) CLMCM1 80/10/15/2104 
($S) CLMCM3 80/10/15/2106 
($S) CLMCM4 80/10/15/2107 
($S) CLMFLT 80/10/02/0811 
($S) CLM 80/09/21/0750 COMPLETED 


v. 
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RESOLA DIRECTIVE 

Directive Name: RESOLA 

The RESOLA directive identifies one or more system overlays 
that are to be loaded into the system area of memory, where 
they will remain resident for the duration of the configured 
system. 

Fo rmat: 

RESOLA overlay_name[,overlay_name]... 

Argument Description: 
overlay_name 

A string of up to six ASCII characters that identify a 
system overlay that is to be made resident for the dura¬ 
tion of the configured system. Appendix B identifies the 
system overlays that can be specified in this argument 
and the function (s) provided by each one. 

Functional Description: 

Each RESOLA directive adds one or more system overlay names 
to a list of resident system overlays. During the Configura¬ 
tion Load Manager's loading phase, each name on the list is 
compared with a table of system overlay names. A match 
causes the indicated system overlay to be loaded into the 
system area of memory. 

If no match occurs, an error is indicated. If one overlay 
name on a RESOLA directive causes an error, all other cor¬ 
rectly specified overlays in the same directive can neverthe¬ 
less be loaded. 

Example: 

RESOLA OYDMT,OZTS UB,OZTUTL 

This example identifies three system overlays (these three 
are used for processing magnetic tape files) that will be 
loaded into the system area of memory, where they will remain 
resident for the duration of the configured system. 


5-65 


CB23-03 



RLOCK 


RLOCK DIRECTIVE 


Directive Name: RLOCK 

The RLOCK directive defines a pool of structures to be used 
by data management when record locking is requested at file 
reservation time. The size of the pool determines the total 
number of records that may be locked at one time. 

One structure is used for each record to be locked. The size 
of each structure is six words for SAF and eight words for 
LAF. These structures are reusable after records become 
unlocked. The RLOCK directive must be included if the 
record lock facility is to be used. If more than one RLOCK 
directive is given, the last one takes effect. 

Format: 

RLOCK [init] , [ inc] , [max] 

Argument Description: 

[init] 

Specifies the number of initial record lock structures. 
The default is 15. 

[inc] 

Specifies the number of record lock structures that can 
be added at one time. The default is 5. 

[max] 

Specifies the total number of record lock structures per¬ 
mitted. The default is 30. An entry of 0 signifies that 
the total number of lock structures is unlimited. If the 
initial size or the increment size is greater than the 
maximum size, the following CLM message is generated. 

133A RLOCK ARGUMENTS INCONSISTENT WITH EACH OTHER 
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NOTES: 1. The initial record lock pool is allocated in 

system memory at the time of the first record 
lock request. 

2. The sizes of all three arguments are rounded up 
so that the amount of memory allocated is a mul¬ 
tiple of 32 words minus 2 for SAF, or 32 words 
minus 3 for LAF. 

Functional Description: 

The record lock facility of the file system provides multi¬ 
user interference protection for records within shared disk 
files. For a detailed description of this facility see the 
Data File Organizations and Formats manual. This facility 
requires that a pool ol record lock structures be created by 
means of the RLOCK directive. Because record lock entries 
are used and surrendered dynamically, the RLOCK pool need 
contain only enough entries to service the maximum number of 
records that will be locked at the same time. The following 
procedure shows how to calculate the size of the record lock 
pool for a system where a number of users perform simulta¬ 
neous transactions. 

Assume that each transaction consists of an update of three 
records. The file system will lock the control intervals 
(Cl's) in which the three records reside, and for indexed 
sequential files it will also lock the record preceding each 
of the accessed records. Thus, a maximum of six Cl's may be 
locked. However, two consecutive records are usually in the 
same Cl; therefore three locked Cl's is a good approximation 
for an indexed sequential file and the exact value for other 
file organizations. 

Assume that ten users perform transactions but never more 
than four users access the data base simultaneously. For 
these assumptions, the initial number of record locks is 12 
(4 x 3) and the natural increment is 3. 

The accuracy of these estimates may be improved by taking 
into account the memory management features. Record lock 
entries are allocated in system memory, and system memory is 
obtained in blocks. (A multiple of 32 minus 2 words for SAF; 
a multiple of 32 minus 3 words for LAF.) In a SAF environ¬ 
ment, record lock entries are six words long. Therefore, for 
SAF, better estimates for initial and increment values would 
be 15 and 5. 

Example 1: RLOCK 


init = 15 
inc = 5 
max = 30 
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RLOCK 


Example 2: RLOCK ,,45 


Example 3 


Example 4 


Example 5 


Example 6 


Example 7 


ini t 
inc 
max 


RLOCK 45,,45 


init 

inc 

max 


RLOCK 45,0,45 

init 

inc 

max 


RLOCK 20,5,60 
RLOCK ,4 


init 

inc 

max 


RLOCK 20,5,60 
RLOCK 20,4,60 

ini t 
inc 
max 


RLOCK , ,0 


init 

inc 

max 


45 


45 

5 

45 Error because 45+5>45 


45 

0 

45 No error 


15 

4 

30 because the last RLOCK 
directive is the effec¬ 
tive one. 


20 

4 

60 


15 

5 

uniimited 


5-68 


CB23-03 



SYS 


SYS DIRECTIVE 


Directive Name: SYS 


The SYS directive defines a number of system variables. 
Format: 


SYS [Hz] , [scan cycle] , 


! SSIP 
DS IP 
CIP 
SCIP 
null 



, [olan] , [tsa] ,[irb] [, ,E] 


Argument Description: 
[Hz] 


Specifies the line frequency at which the system's real¬ 
time clock operates. Possible values are 60 (for 60 Hz) 
and 50 (for 50 Hz). Model 20's and 30's should be con¬ 
figured with a value of 50 if the line frequency is 50 
Hz, and 60 if the line frequency is 60 Hz. Model 40's 
and 50's should always be configured with a value of 60. 
The default value is 60 (the U.S. standard). 


[scan cycle] 


Specifies the time, in milliseconds, between interrupts 
by the system's real-time clock. The default value is 50 
(milliseconds). 


The following values (in milliseconds) are possible for 
scan cycle. 


50 Hz Line 

10 

20 

50 

100 


60 Hz Line 
8 

16 

25 

33 

50 

100 
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Millisecond intervals in cyclic clock request blocks 
should be expressed (if possible) in multiples of the 
scan_cycle. This practice ensures long-term accuracy of 
event synchronization. Otherwise, the full deviation 
between the specified interval and the nearest scan_cycle 
multiple is always realized. 



Specifies that scientific instructions and/or commercial 
instructions will be used in applications. Commercial 
instructions are processed by the Model 47 or Model 57 
Central Processor in configurations so equipped; other¬ 
wise, commercial instructions are processed by a software 
simulator (CIPSIM). Scientific instructions are pro¬ 
cessed by the Scientific Instruction Processor if it is 
present; otherwise, scientific instructions are processed 
by the software simulator (SIPSIM). 

Note that in configurations with a Model 47 or Model 57 
Central Processor, the commercial extension to the inter¬ 
rupt save area is automatically created for each priority 
level except for those levels occupied by drivers, 
regardless of the option specified for this argument. 

The presence of a hardware Scientific Instruction 
Processor automatically creates the commercial and 
scientific extensions to the interrupt save area for each 
priority level except for those levels occupied by 
drivers, regardless of the option specified for this 
arg ument. 


SSIP indicates that single-precision scientific instruc¬ 
tions are to be processed. If the hardware Scientific 
Instruction Processor is not present, the single¬ 
precision SIP simulator (SIPSIM_SP) will automatically be 
loaded during the sytem startup? If the hardware 
Scientific Instruction Processor is present, it is used 
and the single-precision SIP simulator is not loaded. 
(SSIP is permissible for use with BES 2xx FORTRAN 
programs and FORTRAN programs without double precision.) 


DSIP indicates that double-precision scientific instruc¬ 
tions are to be processed. If the hardware Scientific 
Instruction Processor is not present, the double¬ 
precision SIF simulator (SIPSIM) will automatically be 
loaded during system startup. If the hardware Scientific 
Instruction Processor is present, it will be used and the 
double-precision SIP simulator is not loaded. (DSIP is 
permissible for BES 203 — and later -- FORTRAN 
programs.) 
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CIP indicates that commercial instructions are to be pro¬ 
cessed. If the required central processor model is not 
present, you must include an LDBU directive that identi¬ 
fies the commercial simulator (CIPSIM). If the required 
central processor model i_s present, it will be used and 
the Commercial simulator should not be identified in 
an LDBU directive. 


SCIP indicates that both scientific and commercial 
instructions are to be processed. If the hardware 
Scientific Instruction Processor is not present, you must 
include an LDBU directive that identitles the single¬ 
precision SIP simulator (SIPSIM_SP) or the double¬ 
precision SIP simulator (SIPSIM). If a Commercial 
Central Processor model is not present, you must include 
an LDBU directive that identifies the Commercial simula¬ 
tor (CIPSIM). If the hardware Scientific Instruction 
Processor and a commercial central processor are present, 
they will be used and the SIP and commercial simulators 
should not be identified in LDBU directives. 


NOTE: If both SIP and commercial simulators are used, 

the order of the LDBU directives governs the order 
in which the simulators process a trap to the 
single trap vector they share. The simulator 
identified in the last LDBU directive will process 
the trap first . 

null (no entry) indicates that no scientific or commer¬ 
cial instructions are to be processed o_r that any 
required hardware Scientific Instruction Processor and/or 
a commercial central processor model is present and will 
be used. (Thus the corresponding simulator is not used). 

[ olan] 

Specifies the number of 512-word system overlay areas to 
be created. The value for olan must be a decimal integer 
from 2 through 99. The default value is 1, indicating 
one 512-word area to be used for system overlays. 

[tsa] 


Specifies the number of trap sav 
addition to the default number o 
munications), 7 (LAF system with 
(SAF system with communications) 


e areas to be created i_n 
f 6 (system without corn- 
communications) , or 8 


The size 
the size 
words in 


of each additional trap save area is the same 
of each of the default trap save areas (viz., 
a SAF system and 104 words in a LAF system). 


as 

64 
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You have the option of expressing this parameter sym¬ 
bolically by defining it with a VARIABLE directive. See 
the description of the VARIABLE directive elsewhere in 
this section. 

[irb] 

Specifies the number of intermediate request blocks to be 
created in addition to the default number of 20 for the 
system. Each intermediate request block is 8 words in a 
SAF system and 13 words in a LAF system. 

You have the option of expressing this parameter sym¬ 
bolically by defining it with a VARIABLE directive. See 
the description of the VARIABLE directive elsewhere in 
this section. 

[E] 

Specifies that expanded error messages (text in addition 
to code) are to be issued. If this argument is omitted, 
only the error code is issued. 

Once this argument is specified, it remains in effect for 
the duration of the configured system, even if subsequent 
SYS directives appear with this argument nCill. 

This argument is not meaningful if the system is boot¬ 
strapped from diskette; space limitations on diskette 
prevent the presence of the error message library file 
(EMLFILE) . 

Functional Description: 

The SYS directive defines a number of system variables. If 
all of the SYS directive's default values are acceptable, it 
can be omitted. These default values are summarized below. 

Hz - 60 ffe line frequency 

scan_cycle - 50 milliseconds 

SSIP/DSIP/C IP/SCIP - null (no SIP simulator or commercial 

simulator required) 

olan - 1 system overlay area 

tsa - 7 trap save areas 

irb - 20 intermediate request blocks 

E - error code only, no text 
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If multiple SYS directives are specified, only the last one C/3 
is effective; exceptions: (1) all trap save areas and -<^ 

intermediate request blocks specified on all SYS directives (/) 
are added to the system defaults of 7 and 20, respectively, 
and (2) if E is specified in any SYS directive, expanded 
error messages (text in addition to code) will be issued. 

The size of the interrupt save area (and hence the size of 
the task control block, which includes the interrupt save 
area) depends on the CPU Model and SIP/CIP characteristics as 
shown in Table 5-9. 

Table 5-9. Decision Table for Calculating TCB Size, Based 
on CPU Model and SIP/CIP Characteristics 


Conditions: 

Model 23, 33, or 6/34 

Y 





Y 





Y 





Y 





Y 





Model 43, 47, 53, 
or 57 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 


Y 

Y 

Y 

Y 

SIP hardware present? 


N 

N 

Y 

Y 


N 

N 

Y 

Y 


N 

N 

Y 

Y 


N 

N 

Y 

Y 


N 

N 

Y 

Y 

Model 47 or 57 


N 

Y 

N 

Y 


N 

Y 

N 

Y 


N 

Y 

N 

Y 


N 

Y 

N 

Y 


N 

Y 

N 

Y 

Null argument? 

Y 

Y 

Y 

Y 

Y 





















SSIP argument? 






Y 

Y 

Y 

Y 

Y 
















DSIP argument? 











Y 

Y 

Y 

Y 

Y 











CIP argument? 
















Y 

Y 

Y 

Y 

Y 






SCIP argument? 














I 







Y 


Y 

Y 

Y 

Resultant ISA Type: 

Basic ISA 

X 





X 













J 







+ Model 40 and 50 
registers 


X 





X 



















+ CIP context 



X 





X 








X 

X 

X 








+ SIP context 




X 

X 




X 

X 

X 

X 

X 

X 

X 




X 

X 

X 

X 

X 

X 

X 

TCB Size, Based on ISA 

Type 
























SAF Size 

ISA Type (words) 




LAF Size 
(words) 


















Basic ISA 

64 




Not applicable 

















+ Registers 

64 






96 



















+ CIP Context 

96 






96 



















+ SIP Context 

96 






128 



















NOTES: 1. Entry meanings: 


- 

yes 

N - 

no 

X 

- ISA 

type 














2. The basic ISA ends 

wi th 

the Ml-register save 

word . 













3. The ISA for 
M2- through 

Model 43, 47, 53, 
M7-registers, and 

or 57 registers includes the basic ISA, save 
save word(s) for the stack address register. 

words 

for the 

4. The CIP context includes all elements in 

2 words (SAF) or 3 words (LAF) . 

item 2, 

plus 

the CIP-specific context area 

of 

5. The SIP context 
13 words. 

includes all elements in 

item 3, 

pi us 

the SlP-specific context area 

of 

6. All TCB sizes are 

rounded 

up 

to the 

nearest multiple of 

32 words. 
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Example: 

SYS ,25,SSIP,5,,,,E 

This example defines the system variables as shown below. 

(Assume that only one SYS directive is used.) 

• The system line frequency is 60 Hz (default). 

• The scan_cycle of the system's real-time clock is 25 
milliseconds. 

• The single-precision SIP simulator (SIPSIM_SP) will be 
loaded to process scientific instructions, unless the 
hardware Scientific Instruction Processor is present. 

• Five system overlay areas will be created. 

• Six trap save areas will be created (default if no 
communications) . 

• Twenty intermediate request blocks will be created 
(def aul t) . 

• Error codes will be expanded to include message text. 
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VARIABLE DIRECTIVE 


Directive Name: VARIABLE 

The VARIABLE directive defines a single-character symbolic 
expression (chosen from the letters A through Z) that may be 
specified in certain CLM directive statements. 

Variables can define values for the fields in the SYS direc¬ 
tive representing additional trap save areas or intermediate 
request blocks, or memory pool sizes in a MEMPOOL directive. A 
variable must be defined by a VARIABLE directive before it can be 
specified in other CLM directives. 

Format: 


VARIABLE variable=expression 
Argument Description: 
variable 

A single character designation, upper case only, chosen 

from the letters A through Z. 

expression 

Any valid expression that defines the value of the 

variable. expression may equal any of the following: 

• An integer having a value between -32767 and +32767. 

• KSR (Represents the total number of MDC-connected 
terminals finally configured using the KSR value) 

• CON (Represents the total number of MDC-connected 
terminals finally configured with the CON value) 

• TTY (Represents the total number of communications 
devices finally configured by DEVICE TTY directives) 

• VIP (Represents the total number of communications 
devices finally configured by DEVICE VIP directives) 

• ATD (Represents the total number of devices finally 
configured by DEVICE ATD directives) 
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expression, 



expression 2 


An arithmetic combination of two expressions (chosen 
from this list) using addition (+), subtraction (-), 
multiplication (*) or division (/). The value of an 
expression is always an integer; all fractional values 
are truncated, not rounded. For example, 5/3 will be 
passed to the system as having a value of one (1). 

• (expression, ) 


expression, is to be evaluated before being combined 
with any other expression term. The expression is 
always evaluated by the system as an integer; all 
fractional values are truncated, not rounded. For 
example, 5/3 will be passed to the system as having a 
value of 1. At each step of the evaluation of an 
expression, fractional values are truncated, i.e., 
this is strictly integer arithmetic. 

• ( + ) expression 


Specifies a signed value, plus or minus, for the 
expression. Note that "+expression" has the same 
value as "expression". 


• x (where x is the name of an already defined variable) 

Variables may be used when specifying the number of trap save 
areas and intermediate request blocks in a SYS directive, or 
the size of a memory pool in a MEMPOOL directive. Using a 
VARIABLE directive, you can assign symbolic values for these 
fields that will be subsequently resolved by the system. By 
specifying variables in SYS or MEMPOOL directives, the system 
builder creates a generalized CLM file that may be used by 
several similar but not identical hardware configurations. 


Example 1: 




VARIABLE A=TTY*3000 
MEMPOOL ,T1, A 
MEMPOOL S,,* 


,/f \ 

V_y 


5-76 


CB23-03 



Note that in all cases, a variable must be defined in the CLM 
file before it can be used in subsequent directives. The 
variable A has been defined to be equal to the total number 
of TTY terminals finally configured, multiplied by 3000. In 
the MEMPOOL directive, A represents the 3000 words of memory 
that will be reserved for each TTY configured, t’he first 
MEMPOOL directive defines the name and size of the memory 
pool that has reserved 3000 words of memory for each TTY 
terminal. The second MEMPOOL directive allocates all 
remaining memory to the system memory pool. 

By defining memory pools with variables, the system builder 
can accurately account for as many or as few devices as are 
actually configured. He need not know the channel number 
assigned to each device, the memory pool size, or the number 
of devices actually configured. The system assigns these 
characteristics accurately and automatically. 

Example 2: 


VARIABLE B=TTY*3 
VARIABLE C=TTY*2 
SYS , , , ,C,B 


In this example, two variables have been defined for the trap 
save area and intermediate request block fields in the SYS 
directive. C is defined as the number of trap save areas 
that will be allocated for each TTY terminal, in addition to 
the default number. (The value of C equals twice the number 
of TTY terminals configured.) C specifies that each terminal 
will have two trap save areas in 
number. B is defined in the SYS 
intermediate request blocks that 
TTY terminal, in addition to the 
of B equals three times the number of TTY 
figured.) B specifies that each terminal 
mediate request blocks in addition to the 


addition to the default 
directive as the number of 
will be allocated for each 
default number. (The value 
terminals con- 
will have 3 inter¬ 
default number. 
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VARIABLE 


Example 3: (Refer to comments on next page) 

Sample CLM File 

( VARIABLE T=TTY+VIP 
1 < VARIABLE I=KSR+10 
( SYS ,,,,I,T,,E 

DEVICE DS K 0 0,6,1 0, X 1 400' 

DEVICE DSK01,7,11,0 
DEVICE FCD00,8,12,0 
DEVICE RCDO0,9,12,0 
COMM 13 

i DEVICE TTY01,14,14,0 
DEVICE TTY02,15,15,0 
DEVICE TTY0 3,16,16,0 
DEVICE TTY0 4,17,17,0 
TTY 14,14,0,0,300 
TTY 15,15,0,0,300 
TTY 16,16,0,0,300 
TTY 17,17,0,0,300 
3 ( VARIABLE Z=TTY*500 
( MEMPOOL ,L 0,Z 
4 ( MEMPOOL S,,* 

| QUIT 

Example 3 Comments: (Refer to the sample CLM file) 

1. Variables T and I have been defined in VARIABLE direc¬ 
tives replacing constant values in the SYS directive. T 
equals the total number of TTY and VIP terminals con¬ 
figured. I equals 10 plus the number of KSR terminals 
configured. In the SYS directive, T replaces some con¬ 
stant value in the trap save area field; I replaces some 
constant value in the intermediate request block field. 

In this context, T specifies one additional trap save 
area for each TTY or VIP configured; I specifies that the 
number of additional intermediate request blocks equals 
10 more than the number of KSR terminals configured. 

2. A maximum of four TTY terminals may be configured, 
depending on the number of available channels (with 
asynchronous line adapters). All terminals have floating 
channel assignments and are configured in the order in 
which they appear in the CLM file. 

3. The variable Z is defined such that 500 words of memory 
are allocated for each configured TTY terminal. (Z 
equals 500 times the number of configured TTY terminals.) 
In the MEMPOOL directive that follows, Z specifies that 
pool L0 allocates 500 words of memory for each TTY con¬ 
figured. The size of pool L0 could be 500, 1000, 1500, 
or 2000 words, depending on the final number of TTY 
terminals actually configured. 
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4. 


This MEMPOOL directive allocates all unreserved memory to 
the system memory pool. 
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SECTION 6 

CLM DIRECTIVES FOR A COMMUNICATIONS CONFIGURATION 


This section describes the CLM directives used to define the 
communications environment of the system software. Communica¬ 
tions CLM directives may be entered from the CLM_USER file or 
from any file or device specified in a CLMIN directive. There¬ 
after, a system startup can be performed. 

If your installation includes communications (MLCP/DLCP- 
connected) devices, you should have the Communications Processing 
manual available for reference. ~ 

The communications-related CLM directives cause the following 
functions to be performed: 

• Data structures (i.e., tables) are established correspond¬ 
ing to the communications hardware available to your 
system. 

• The following bound units are loaded into the central 
processor's main memory: 

Communications supervisor and multiline/dual line com¬ 
munications processor (MLCP/DLCP) driver. 

One or more line protocol handlers (i.e., TTY, VIP, 

ATD, STD, BSC, PVE, HASP, RCI, or user-written). 

• The following elements are loaded into the RAM (random 
access memory) of one or more Communications controllers: 

Data set channel control program. 

Channel control programs of one or more line protocol 
handlers. 

Table 6-1 summarizes the communications-related CLM direc¬ 
tives, which are described in alphabetic order in this section. 
Table 6-2 provides detailed information on physical devices sup¬ 
ported by various directives. 


6-1 


CB23-03 



Table 6-1. Summary of Communications-Related CLM Directives 


Directive 

Meaning 

ACU 

Defines an Auto Call Unit and associates the ACU 
channel with a data communications channel. 

Optionally, provides one or more telephone numbers 
to be used in establishing a connection for the 
associated data communications channel. 

ATD a,b,c 

Identifies a station on a line serviced by the 
asynchronous terminal device (ATD) line protocol 
handler. 

BSC 

Identifies a station on a line serviced by the BSC 
(binary synchronous communications) line protocol 
handler. 

COMM 

Establishes the priority level (s) at which the 
MLCP/DLCP interrupts the central processor. 

DEVICE 

Indicates that the designated communications 
station is to be accessible through the file system 
interface. 

EQLRN 

Defines multiple logical resource numbers (lrn's) 
for the same physical communications device. 

HASP 

Identifies a remote workstation services by the 

HASP protocol. 

H 3270 

Identifies a station on a line serviced by the BSC 

3270 protocol. 

LPHn 

Identifies the first (or only) station on a line 
serviced by a user-written line protocol handler. 

LPHDEF 

Indicates nonstandard table sizes for channels and 
stations controlled by a user-written line protocol 
handler. 

MODEM 

Defines a nonstandard modem type. 

POL1ST 

Identifies the start of the poll list on a line 
serviced by the synchronous terminal device line 
protocol handler. The line is identified by a 

STDLN directive. 

PVE 

Identifies a polled VIP emulator "station" on a 
line serviced by the VIP line protocol handler. 


6-2 


CB23-03 
























Table 6-1 (cont). Summary of Communications-Related 

CLM Directives 


Directive 

Meaning 

RCI 

Identifies a remote batch terminal services by the 
RCI protocol. 

ROP 

Indicates that a receive-only printer is connected 
to a station on a line serviced by the synchronous 
terminal device line protocol handler. The line is 
identified by an STDLN directive and the station is 
identified by an STD directive. 

STAPOL 

Defines a sequence of station poll addresses to be 
added to the poll list of a line serviced by the 
synchronous terminal device (STD) line protocol 
handler. The line is identified by an STDLN 
d i rective. 

STD d 

Identifies a station on a line serviced by the syn¬ 
chronous terminal device (STD) line protocol hand¬ 
ler. The line is identified by an STDLN directive. 

STDLN d 

Identifies a line serviced by the synchronous 
terminal device (STD) line protocol handler. 

STATION 

Identifies the second or subsequent station on a 
line serviced by a user-written line protocol 
handler. 

STTY 

Specifies the file characteristics of a device that 
is not a disk device or a unit-record device. 

TTY c 

Identifies a station on a line serviced by the TTY 
(teleprinter) line protocol handler. 

VDAM 

Incorporates the Display Formatting and Control 
software component in the configuration. 

VI P d 

Identifies a polled or nonpolled synchronous visual 
information projection (VIP) terminal on a line 
serviced by the VIP line protocol handler. Option¬ 
ally, identifies an ROP (receive-only printer) sta¬ 
tion on the same line. 

VROSY 3 

Identifies a PRU1001/1003/1005 device on a line 
serviced by the ATD line protocol handler. 
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Table 6-1 (cont). Summary of Communications-Related 

CLM Directives 


Directive 

Meaning 

VTTY a 

Identifies a teletype-like device on a line serv¬ 
iced by the ATD line protocol handler. 

V7200 a,b 

Identifies a VIP7200 or VIP7205 device on a line 
serviced by the ATD line protocol handler. 


The ATD directive is intended as a replacement for the VROSY, 
VTTY, and V7200 directives. The protocol handler called by 
the ATD directive offers additional support capabilities 
e.g., block mode support of VIP7801/02 devices, support of the 
VIP7207 device) not offered by the line protocol handler 
called by the VROSY, VTTY, and V7200 directives. The VROSY, 
VTTY, and V7200 directives can still be used. 

b The ATD directive or the V7200 directive must be specified if 
VIP7200 or VIP7801/02 terminals are to be used for forms 
processing using Honeywell's Display Formatting and Control 
Facility. 

c The TTY directive and the ATD directive support asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleprinter 
mode. The TTY line protocol handler does not provide block 
mode support of VIP7801/02 devices; neither does it provide 
support for VIP7200 devices and VIP7801/02 devices in forms 
processing mode. (For these functions the ATD directive is 
required.) ATD line protocol handler does not provide the 
transparent I/O or single character mode functions of the TTY 
line protocol handler. 


d The STD directive and the VIP directive support synchronous 
terminal devices. The line protocol handler called by the STD 
directive offers additional support capabilities (e.g., 
support of VIP7804 and VIP7805 terminals) not offered by the 
line protocol handler called by the VIP directive. 
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Table 6-2• CLM Directives and Supported Communications Devices 


Directive 

Devices Supported 



ATD 

VIP 7200 

VIP 7205 

VIP 7801 

VIP 7802 PRU 1001/1003/1005 

VIP 7207 TWU 1001/1003/1005 

Receive-only printers: 

PRU 1001/1003/1005 

BSC 

Level 6 central processor 

HASP 

IBM central processor 

H3270 

IBM central processor 

PVE 

Level 6 central processor 

RCI 

Level 66 host processor 

STD 

VIP 7700 VIP 7700R 

VIP 7705R VIP 7760 

VIP 7804 VIP 7805 


Receive-only printers: 

TN 300 

TN 1200 

PRU 1003/1005 

TTY 

VIP 7100 VIP 7200 

VIP 7105 VIP 7205 

VIP 7801 VIP 7802 

TWU 1001/1003/1005 

VIP 

VIP 7700 VIP 7700R 

VIP 7705R VIP 7760 

VIP 7805 VIP 7804 


Receive-only printers: 

TN 300 ASR-33 

TN 1200 ASR-35 

PRU 1003/1005 

VROSY 

PRU 1001/1003/1005 
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Table 6-2 (cont) . CLM Directives and Supported Communications 

Devices 


Directive 

Devices Supported 

V7200 

VIP 7200 VIP 7801 

VIP 7205 VIP 7802 

VTTY 

ASR-33 KSR-33 

ASR-35 


You should observe the following rules for arranging 
communications-related CLM directives: 

1. The COMM directive must precede all other communications- 
related CLM directives. 

2. If an LPHDEF directive is used in association with a 
user-written line protocol handler, the LPHDEF directive 
must precede all related LPHn directives. 

3. If STATION directives are used in association with an 
LPHn directive (in cases where a user-written line pro¬ 
tocol handler drives more than one station per line) , 
the STATION directives must immediately follow the 
related LPHn directive. 

4. The DEVICE directive should follow related LPHDEF, 
STATION, and LPHn directives and related POLIST, STAPOL, 
ROP, STDLN, and STD directives. 

5. If an ACU directive is used, the station whose lrn 
appears as an argument in the ACU directive must be 
defined in the directive that immediately precedes this 
ACU directive. 

6. When polled VIP's are connected to a communications line, 
the VIP directives for the stations on the line must be 
consecutive. 

7. When polled VIP emulator (PVE) stations are associated 
with a communications line, the PVE directives for all 
the stations on the line must be consecutive. 

8. The value .assigned to the communications interrupt level 
(by the COMM directive) is normally restricted to the 
range 7 through 57. At initial startup, the bootstrap 
device is assigned level 6 by the system. If the level 
assigned to the bootstrap device is changed to a lower 
level (higher number) by a DEVICE directive, the communi¬ 
cations interrupt level can be specified as 6. The level 
that is assigned to a communications device associated 
with a COMM directive is normally 8 through 58. 
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9. When an MLCP/DLCP operator console is configured, it must 
be assigned LRN 0. 

10. Configuring a line serviced by the STD line protocol 
handler requires at least the directives STDLN, STD, 
POLIST, and STAPOL. An STD line may also use a ROP 
directive. The following diagram illustrates the 
sequence rules for STD directives. Brackets enclose 
optional directives. One set of these directives must be 
specified for each line: 

STDLN must specify one for each line 

STD, 

[ROP] specify one for each i specify one set for each 

station, if needed >station on the line; all 

) must precede POLIST 

std 2 

[ROP] 


POLIST must specify one for each line 

STAPOL must specify one or more for 

each Mne; all STAPQL 
directives should be speciifed 
in the order in which stations 
are to be polled 

[DEVICE] (optional) specifies that the device will be 
accessible to the file system 

11. As a general rule, two line protocol handlers are allowed 
per MLCP/DLCP. 

12. The STTY command keyword format, as described immediately 
following the STTY directive, may be used as an alterna¬ 
tive to the STTY directive format in your CLM file. The 
STTY command format provides additional features not sup¬ 
ported by the STTY directive format. For example, if you 
wish to specify a terminal as being automatically recon- 
nectable following a power failure or line drop, you must 
configure the terminal using the STTY command format in 
your CLM file. (For a complete description of this capa¬ 
bility, see Appendix D.) 

13. Each directive for a communications dev ice must reference 
a unique 1ogica1 resource number (lrn). If you wish to 
specify multiple communications directives which refer¬ 
ence the same physical device, you should use the EQLRN 
directive. The EQLRN directive is described later in 
this section . 
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TOPICS RELATED TO COMMUNICATIONS DIRECTIVES 


The following paragraphs describe: 

• How to assign channel numbers to your communications 
devices, or, how to let the system dynamically assign 
channel numbers 

• How to modify a terminal's line length 

• How to let the system dynamically assign a terminal's line 
speed 

• The amount of resident code required for communications 
modules. 

You should review each of these topics before you create your 
CLM directive file. 


Assigning Channel Numbers 


Channel control programs are loaded into the MLCP on the 
basis of channel numbers you specify for communications devices. 
You should observe the following guidelines when assigning chan¬ 
nel numbers to your communications devices: 


a. As a general rule, no more than two line protocol hand¬ 
lers can be associated with a given MLCP. 

b. The MLCP with which a particular line protocol handler is 
associated is determined by the channel number(s) you 
enter for communications devices. The system checks the 
first six bits of the hexadecimal channel number you 
specify to determine LPH allocation. 


This range of ' 

/ FC00 - FF80> 
, F800 - FB80 
F400 - F780 j 

' causes the 1 

channel numbers > 

F000 - F380 ' 

^ LPH to go 7 

specified for a 
device 

i EC00 - EF80 j 

V • 1 

1 # J 

into \ 


first MLCP 
second MLCP 
third MLCP 
fourth MLCP 
fifth MLCP 


c. 


Each channel number must 
ending in 00 or 80. Note 
0400 are unavailable for 


be a 4-digit hexadecimal number 
that channel numbers lower than 
communications devices. 


DYNAMICALLY ASSIGNED CHANNEL NUMBERS 

For MLCP/DLCP-connected devices, channel numbers may be 
dynamically assigned or "floated" in TTY, VIP, VROSY, VTTY, ATD, 
V7200, or DEVICE directives. 
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Assigning zero channel numbers to directives in 
relieves the system builder of the need to know the 
assignments for each installation that will receive 
system software. 


the CLM file 
channel 
a copy of the 


For each communications device configured, you have the 
option of specifying a channel number in the appropriate direc¬ 
tive or allowing the system to dynamically assign or "float" 
channel assignments at the startup time. To float a channel, you 
specify the channel number parameter in the appropriate directive 
with a single zero (0). The system then assigns directives with 
floating channels to the first available devices on the bus. 

Note that if you specify a floating channel and the system cannot 
locate an appropriate device, no error message is issued; the 
system ignores this directive. 

If your system includes device adapters but not associated 
devices, it is recommended that explicit channel numbers be 
assigned to all devices within the device class. 


Channel numbers are assigned as soon as the first floating 
channel is encountered in the CLM file. To prevent devices with 
floating channels from inadvertently preempting devices whose 
channel numbers are explicitly specified, all directives of a 
given type with explicitly specified channel numbers should pre¬ 
cede all directives of that type with floating channels in the 
CLM file. All active channels should have higher bus addresses 
than all inactive channels to prevent the system from inadver¬ 
tently assigning a device to an inactive channel. 

For MLCP/DLCP-connected devices, the first available channel 
with the highest bus address and appropriate channel adapter 
(asynchronous or synchronous) will be assigned to the first 
floatable channel in a communications directive, and so on. 

NOTE: Assigning floatable channels to communications devices 

is recommended only if all devices will be configured 
identically (if, for example, a system specifies that 
all asynchronous devices will be directly-connected 
VIP 7200's with identical line speeds, DEL characters, 
stop bits, and parity). The system cannot distinguish 
between different types of MLCP/DLCP-connected 
dev ices.' 


'The M4_SYSDEF program does not permit you to configure MLCP/DLCP 
connected devices with floating channel numbers. M4_SYSDEF 
requires the system builder to supply all channel numbers for 
communications devices. 
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If a system is configured with devices containing floatable 
channel numbers, the system builder may determine all channel 
numbers assigned by the system as soon as possible after a system 
initialization. The system operator can issue the command 
STS -ALL to list each device and its channel number assignment. 

See Section 5 for an example illustrating the use of floating 
channel number assignments. 

Modifying Terminal Line Length 




The line length specified for a terminal or other input 
device at system building time overrides the command processor 
line length of 127 characters. For example, at a terminal con¬ 
figured with a line length of 80 characters, you cannot enter a 
continuous command line longer than 80 characters unless you type 
an ampersand (&) at the end of the line and then continue on one 
or more additional lines. You can alter the terminal's line 
length by using the set terminal characteristics (STTY) command 
(described elsewhere in this manual) after system initialization 
or by modifying the STTY directive in your CLM file. 

Terminal Line Speed Selection Capability (Asynchronous 
Terminals Only) 

When you specify an ATD, TTY, LPHn, VTTY, or V7200 directive, 
you have the option of deferring selection of an asynchronous 
terminal's line speed (specified by the fifth parameter) until 
the terminal comes online'. To defer selection of a terminal's 
line speed, you specify the fifth parameter as either 'HI' or 
'LO' in one of the above-mentioned directives. Choosing this 
option frees you from specifying an exact line speed for every 
asynchronous terminal in your configuration. The interactive 
system building program, M4_SYSDEF, incorporates this deferred 
speed selection capability. 

In order to allow the system to determine the terminal's line 
speed, the operator presses the RETURN key on the terminal's key¬ 
board when the terminal comes online. If, after several seconds, 
normal terminal operations have not begun, the operator should 
check for one of the following problems: 

1. The terminal's line speed may not be witbin the range 

specified in the appropriate CLM directive. The operator 
may be able to adjust the terminal's line speed to fall 
within the **~nge specified by the directive. The opera¬ 
tor should then press the RETURN key. If, however, the 
terminal's line speed is fixed, adjustments must be made 
to the appropriate CLM directive. You may be required to 
change the designation of the terminal's line speed in 
the appropriate CLM directive. 


>l£ you cKoose this option, an Auto Call Unit must not be config- V - 
ured for the terminal. 
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2 . 


If the carriage return character was garbled and the sys¬ 
tem could not determine the line speed of the terminal, 
the operator should press the RETURN key again. 


( 

3. If the terminal's modem has gone offline, the operator 
must dial up the line again. 

If the system fails to receive a character transmission 
within 60 seconds, the terminal will be disconnected. 

Resident Code Requirements for Communications Modules 

The following table defines the number of words of resident 
code required for various communications modules; the table also 
lists the memory required in the MLCP/DLCP for associated channel 
control programs (CCP's). Memory requirements for noncommunica¬ 
tions modules are defined in Section 5. 


Table 6-3. Communications Memory Requirements 


Component 

Resident 

Memory 

(SAF) 

(in words) 

Resident 

Memory 

(LAF) 

(in words) 

MLCP Memory 
Required for 
CCP 1 

(in bytes) 

DLCP Memory 
Required for 
CCP 2 

(in bytes) 

Comm Supervisor 

2.4K 

2.5K 

N/A 

N/A 

Autocall 

. 4K 

. 4K 

128 

206 

Speed select 

. 2K 

. 2K 

N/A 

N/A 

TTY Line 

Protocol Handler 

1.7K 

1.7K 

1429 

1772 

VIP Line 

Protocol Handler 

2.4K 

2.5K 

1346 

1760 

BSC Line 

Protocol Handler 

2.6K 

2.6K 

1100 EBCDIC 
817 ASCII 

1574 EBCDIC 
1126 ASCII 

PVE Line 

Protocol Handler 

2.3K 

2.3K 

742 

1182 

RCI Line 

Protocol Handler 

2. OK 

2. OK 

188 

235 

ATD Line 

Protocol Handler 

5.9K 

6. IK 

824 

1212 


( 
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Table 6-3 (cont) 


Communications Memory Requirements 


Component 

Resident 

Memory 

(SAF) 

(in words) 

Resident 

Memory 

(LAF) 

(in words) 

MLCP Memory 
Required for 
CCP 1 

(in bytes) 

DLCP Memory 
Required for 
CCP 2 

(in bytes) 

STD Line 

Protocol Handler 

3.6K 

3. 5K 

800 

1226 

3270 Line 

Protocol Handler 

2. IK 

2. IK 

1158 

1758 

HASP 

6.8K 

7.2K 

282 

446 


Note: Sizes do not include patch space sizes. Patch space is 

only required as patches are added. 


'2942 bytes of RAM memory are available in the MLCP for the load¬ 
ing of channel control programs. Any combination of the various 
CCP's can be loaded into the MLCP provided the total memory does 
not exceed 2942 bytes. 

2 3844 bytes of RAM memory are available in the DLCP for the load¬ 
ing of channel control programs. Any combination of the various 
CCP's can be loaded into the DLCP provided the total memory does 
not exceed 3844 bytes. 
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ACU 


ACU DIRECTIVE 


Directive Name: ACU 


The ACU directive identifies an Auto Call Unit and associates 
the ACU channel with a data communications channel. The ACU 
directive must immediately follow the directive describing 
the station whose lrn is specified in the ACU directive. The 
ACU directive cannot be associated with any data communica¬ 
tions channel that supports the speed select option. 

The ACU directive permits the addition of telephone numbers 
to a list of numbers maintained for a data communications 
channel. The list of telephone numbers for a data communica¬ 
tions channel can be unlimited and has the following format: 


Entry 0 
[Entry 1 
[Entry 2 


empty (initially) 
phone_number 11 
phone_number 2] 


[etc. 1 

The Auto Call Unit dials each number in the list three times 
at 40-second intervals until the list is exhausted or a con¬ 
nection is made. 


The first ACU directive that relates an Auto Call Unit to 
this data communications channel causes an empty entry 0 to 
be established; this entry in the list may be loaded and 
reloaded, as desired, by means of an SDL (set ACU telephone 
number) command or $SDL macro call. The first ACU directive 
also creates an entry in the table (starting with entry 1) 
for each telephone number (if any) specified in the direc¬ 
tive. Any subsequent ACU directive relating the same ACU 
to the same data communications channel causes one or more 
additional entries to be added to the list; the additional 
entries are added to the end of the list in the order in 
which the telephone numbers appear in the ACU directive. 


Format: 


ACU lrn, lev el, X' acu__cha nnel' [,' phone # 1[ ,' pho ne_# 2 '[,...] 11 
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ACU 


Argument Description: 
1 rn 


The logical resource number of any station on the data 
communications channel with which this Auto Call Unit is 
associa ted. 

level 

The priority level of the station whose lrn appears in 
the lrn argument of this directive. 

X'ac u_channel' 

A 4-digit hexadecimal number (from X'0400' to X'FF80') 
specifying the channel number of the Auto Call Unit. 

Bits 0 through 9 - The 10~bit channel address of the send 

or recieve channel on the line. 

Bits 10 through 15 - Must be set to zero. 

['phone_#n'] 

A string of 1 to 16 ASCII characters chosen from the set 
0123456789 - (separator) * #. 

FUNCTIONAL DESCRIPTION: 

n ACU directive causes the Auto Call Unit to initiate a line 
connection with a remote auto answer data set. When the 
software issues a connect order and bit 2 of the IORB is set 
to one, the Auto Call Unit attempts to dial a line using the 
list of telephone numbers established at configuration time. 
The Auto Call Unit dials each number in the list three times 
at 40-second intervals until a connection is made or the list 
is exhausted. 

Example: 


TTY 26,8,X'FC00 1 

ACU 2 6,8,X'FDO0' , '1-555-240-02 81 1 

In this example, an Auto Call Unit on channel FD00 is asso¬ 
ciated with the data communications channel (FC00) servicing 
a TTY whose logical resource number is 26 and whose priority 
level is 8. Since this is the first ACU directive for this 
Auto Call Unit, the telephone numbe r in the ACU directive is 
established as entry 1 in the list of telephone numbers for 
the indicated data communications channel (FC00). Note that 
the ACU directive i mmediately follows the TTY directive that 
describes the sta tion who se lrn appears in the ACU d irective. 
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ATD 


ATP DIRECTIVE 

Directive Name: ATD 

The ATD directive identifies a station on a line serviced by 
the asynchronous terminal device line protocol handler. This 
directive is used to configure asynchronous terminals as part 
of the communications system. The ATD directives must follow 
the COMM directive in the CLM file. You can float the chan¬ 
nel number assignments in this directive, if you wish. 

Fo rmat: 

ATD lrn, level,X'channel',[modem] ,[speed] ,[ 1 dev ice-type'] 

[del] , [stop-bit] [,parity] 

Argument Description: 
lrn 

The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the ATD line protocol handler 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
TTecf in "the’ COMM directive. 

X'channel' 

You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 
X'040n' to X'FF8n'), that specifies the channel number of 
the station and the interrupt priority level (n) of the 
line. The channel number has the following format: 


6-15 


CB23-03 



ATD 


Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor, n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible val¬ 
ues are as follows: 

0 - Direct Connect. 

1 - Bell lxx-type modem (103A, etc.). Both data-set- 

ready and carrier-detect signals are required for a 
connection; absence of these signals is a 
disconnection. 

3 or greater - User-defined modem type (see "MODEM 

Directive," earlier in this section). 

The default value is modem type 1. 

[speed] 

The data rate in bits per second. 

For an asynchronous line with a communications-pac whose 
id is 2108 16 , use one of the following values for speed: 

50 300 2400 

75 600 3600 

(default) 110 900 4800 

134 1200 7200 

150 1800 9600 

For an asynchronous line with a communications-pac whose 
id is 2100 16 , 2110 16 , or 2118 16 , use one of the following 
values for speed: 

50 200 1800 

75 300 2000 

(default) 110 600 2400 

134 1050 4800 

150 1200 9600 

NOTE: *If the data rate is 134.5, specify 134. 
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You have the option to defer selection of the line speed 
until the terminal comes online. You select this option 
by specifying HI or LO. 

'HI' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 

’ LO' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 

For more information about the line speed selection capa¬ 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 

['dev ice-type'] 

Specifies the type of terminal used. If this argument is 
not specified, the default is TTY. Possible values are: 


Value 


levices supportec 


7200 VIP 7200, VIP 7205 


7801 VIP 7801, VIP 7802 


D7200 VIP 7207 


PRU PRU 1001, PRU 1003, PRU 1005, 

TWU 1001, TWU 1003, TWU 1005 

TTY An asynchronous terminal 

that is to be supported as 
teleprinter-compatible 

[del] 

In TTY mode, a head-of-form sequence (pre-order control) 
consisting of three LF's and the number of DEL characters 
specified by this argument is generated if the following 
conditions are met. (If the conditions are not met, no 
head-of-form sequence is generated.) 

• The first byte of the application's buffer must 
be designated as a control byte; i.e., bit 4 of 
the IORB's device specific word (I__DVS) must be 
set to 0 at write time. 
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* 


• The control byte must specify that a head-of-form 
sequence is to be generated; i.e., bit 3 of the 
control byte must be set to 1. 

• Device type PRU is not specified. If it is speci¬ 
fied, a true head-of-form is issued. 

In the field or TTY modes, an LF in an end-of-message 
sequence (post order control) is followed by the number 
of DEL characters specified by this control argument. 


The EOM sequence is controlled by the B- and C-bits of 
the IORB's device-specific word I_DVS, as specified by 
the application at write time. The TTY line protocol 
handler sends an EOM sequence according to the following 
B- and C-bit values: 

I_DVS Bits 


B C 


EOM Sequence 


0 

0 

1 

1 


0 CR 

1 None 

0 CR,LF,DEL characters 

1 LF,DEL characters 


At read time, the application can specify the same B- and 
C- bit values in order to send an EOM sequence back to 
the terminal when the message is successfully received. 


Note that an LF character in a pre-order control speci¬ 
fied by the I_CON word of IORB is never followed by a 
DEL character, i.e., this control argument has no effect 
in this case. 


This argument allows you to select 1 to 32 DEL char¬ 
acters. The default for each type of device is as 
follows: 


Device-Type Number of DEL Characters 


7200 0 

7800 0 

PRU1001/1003/1005 1 

TTY 1 


[stop-bit] 

Specifies the number of stop bits that are to follow each 
character. A value of 1 or 2 can be chosen for each 
device. Default values are as follows: 
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Number of Stop Bits 


1 

(For speeds greater 
than 110 bits per second) 

2 

(For a speed of 110 bits 
bits per second or less) 

[parity] 

Specifies the type of parity ("ODD" or "EVEN") to be 
used. The default is EVEN. 

* 

Example: 

ATD 15,17,X'F800' ,0,150,'7200' | 

In this example a VIP 7200 terminal is connected to a line 
serviced by the ATD line protocol handler. The device 
defaults for del, stop-bit, and parity are assumed. 
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BSC DIRECTIVE 

Directive Name: BSC 

The BSC directive identifies a station serviced by the binary 
synchronous communications line protocol handler. 1 

Format: 

BSC 1rn ,level ,X'channel' ,[modeml ,[primary/secondary] , 

[characterise^ [ ,mul ti__block_^count] 

Argument Description: 

lrn 

The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 252. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 62; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci- 
TTecT in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


ilf the station is to be accessible through 
interface, an appropriate DEVICE directive 
the BSC directive (see "DEVICE Directive," 
tion). If input/output to the station is 


the B (buffered) 
directive. 


the file system 
must be "paired" with 
later in this sec- 
to be asynchronous, 


argument must be included in the DEVICE 
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X'channel 1 

A four-digit hexadecimal number (from X'040n to X'FF8n') f 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor, n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc) . The data-set- 

ready signal is needed for a connection; absence of 
this signal is a disconnection. 

3 or greater - User-defined modem type (see "MODEM direc¬ 

tive," later in this section) . 

The default value is modem type 2. 

[primary/secondary] 

Values may be specified as P or S; indicates whether this 
is a primary or secondary endpoint of the transmission. 

A primary endpoint (the default) has priority in conten¬ 
tion mode. 

[character-set] 

One of the following may be specified: 

AS ASCII (the default). 

EB EBCDIC. 

The user is responsible for using the correct character 
set. The BSC protocol does not perform character 
translation. 
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[multi__block__count] 

An integer from 1 to 7 specifies the maximum number of 
data blocks for a single transmission in multi-block 
mode. The default is that multi-block mode is not used. 

Example: 


BSC 29,6,X'FD00',2,S,EB 

DEVICE BSC00,29,6,X'FD00',HOST,,B 

In this example, line FD00 is used for communications with 
another computer. Modem type 2 is used for the line. The 
Level 6 computer is the secondary endpoint on the line. A 
file system interface is established for the station by the 
DEVICE directive. Multiblock mode is not used. 



6-22 


CB23-03 



COMM 


COMM DIRECTIVE 


Directive Name: COMM 

The COMM directive is mandatory in a system that includes 
communications. It specifies from one to four priority 
levels at which communications lines can interrupt the cen¬ 
tral processor. The COMM directive must precede all other 
communications-related CLM directives. 


Format: 


COMM 


level J) [,[level__l] [ ,[level_2] [ , [ level_3 ] ] ] ] 


Argument Description: 

level_jD 
[level^l] 

[level_2] 

[ level__3 ] 

The four possible priority levels at which a communications 
line interrupts the central processor. At least one priority 
level must be specified. Values for level__0 through level__3 
must be in the range of 7 through 61 and must not duplicate 
any other non-communications device priority levels. Each 
value chosen for level__0 through level_3 must be greater or 
equal (have a lower or equal priority) to the preceding 
level. The default values for level__l through level__3 are 
equal to the value assigned to the next highest priority 
level (level (n-1)). For example, if a 
not been assigned for level__2 in a COMM 
priority value specified for level_l is 
third TTY directive in the example that 


priority value 
directive, the 
assumed. (See 
follows .) 


has 


the 


Functional Description: 

The COMM directive specifies from one to four priority levels 
at which communications lines can interrupt the central pro¬ 
cessor, as described above. 


The interrupt level for a communications line is speciifed 
by the values of bits 14 and 15 of the channel number argu¬ 
ment in the directive that identifies the line. Bits 14 
and 15 correspond to the positions of the level__n arguments 
specified in the COMM directive. 
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Example: 

priority 
(interrupt) 
level 

COMM 10, 11 

TTY 20,20,X'FFOO'levelj) 10 
BSC 21,21,X ' FC01' ,.. . level__l 11 

BSC 22,22,X'FC81',... level__l 11 

In this example, three line protocol handlers are configured. 
The TTY associated with lrn 20 processes interrupts on level 
10; the BSC station with lrn 21 processes interrupts on level 
11, as does the BSC station with lrn 22. 


zf \ 
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DEVICE DIRECTIVE 


Directive Name: DEVICE 


communications station 
the file system inter- 


The DEVICE directive is required for a 
only if it is to be accessible through 
face. In this case, the DEVICE directive must be "paired" 
with the appropriate station-defining directive (i.e., TTY, 
ATD, STD, VIP, BSC, PVE, HASP, or RCI) so that each pair con¬ 
tains the same lrn, level, and channel number. You may float 
channel numbers, if you wish. The DEVICE directive should 
follow related LPHDEF, STATION, and LPHn directives and 
related POLIST, STAPOL, ROP, STDLN, and STD directives. 


You must 
your CLM 
operator 
Operator 

Format: 


include a special format of the DEVICE directive in 
file if your installation will use a dual-purpose 
terminal. Refer to "Configuring a Dual-Purpose 
Terminal" in Section 5. 


DEVICE device__unit ,lrn ,level ,X'channel' , [device__name] , 


[ record^si ze] 
Argument Description: 
device unit 




A string of up to six ASCII characters; the first three 
or four characters identify the type of station and the 
last character (alphanumeric) identifies one specific 
station of that type, 
unit are as follows: 


The permissible v a I u e s o £ * <3 evT c e__ 


TTYnn 

BSCnn 

XBSCnn 

VIPnn 

PVEnn 

ROPnn 

ATDnn 

STDnn 

HASPnn 

RClnn 
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The default characteristics of various types of stations are 
given below. Some of the default characteristics are specified 
by the default value of the device specific words (dsw). Certain 
default characteristics for any station in the configuration can 
be changed by use of the CLM directive STTY which is described 
later in this section. The description of the STTY directive 
includes an explanation of the device specific words. 

In addition, a user can override (temporarily change) certain 
default characteristics of a station he is using by the system 
command STTY or the macro call $STTY. 

TTYnn 

• Record size: 73 bytes (including control byte) 

• Device specific word for connect/disconnect = 0 

No autodial used 

Hang up phone on disconnect 

Queue abort 

• Device specific word for read/write = 0030 
(hexadecimal) 

Trailing carriage return 
Trailing line feed 

- Echo mode 

Leading control byte 

• Detab is ON 

• Input is asynchronous 

• Output is asynchronous 

• Type is bidirectional 

BSCnn 

• BSC 2780 protocol 

• Record size: 137 bytes (including control byte) 

• Device specific word for connect/disconnect = 0 

- No autodial used 

Hang up phone on disconnect 
Leading control byte 
Queue abort 

Buffer mode is single record 
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• Device specific word for read/write = 0000 
(hexadecimal) 

- Leading control byte 

• Detab is OFF 

• Input is nonbuffered synchronous 

• Output is nonbuffered synchronous 

• Type is input only between connects or output only 
between connects 

XBSCnn 

• BSC 3780 protocol 

• Record size: 137 bytes (including control byte) 

• Device specific word for connect/disconnect = 0 

Hang up phone on disconnect 

- Queue abort 

• Device specific word for read/write = 0040 
(hexadecimal) 

Leading control byte 

• Detab is OFF 

• Input is asynchronous 

• Output is asynchronous 

• Type is bidirectional 
VIPnn 

• Record size: 81 bytes (including control byte) 

• Device specific word for connect/disconnect = 0100 
(hexadecimal) 

Logical read time-out interval is 10 minutes 

- No autodial is used 

Home cursor on page overflow 
Leading control byte 
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- Poll interval of one second (ignored if nonpolled 
VIP) 

Hang up phone on disconnect 
Queue abort 

- Do not save function codes in read IORB (Input/ 
Output Request Block) 

• Device specific word for read/write = 0010 
(hexadecimal) 

Trailing carriage return 
Trailing line feed 
Input/Output is asynchronous 
Type is bidirectional 

PVEnn 

• Record size: 81 bytes (including control bytes) 

• Device specific word for connect/disconnect = 0 

No autodial is used 

- Do not save function codes in read IORB 
Hang up phone on disconnect 

- Queue abort on disconnect 

• Device specific word for read/write = 0 

• Detab is ON 

• Input is asynchronous 

• Output is asynchronous 

• Type is bidirectional 
ROPnn 

• Record size: 73 bytes (including control byte) 

• Device specific word = 0000 (hexadecimal) 

Trailing carriage return 
Leading control byte 
Physical disconnect 
Queue abort 

• Detab is ON 

• Input is asynchronous 

• Output is asynchronous 



i<f '\ 
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• Type is output 
ATDnn 

• Record size: 73 bytes 

• Device specific word for connect/disconnect = 0 

No autodial is used 

Hang up phone on disconnect 

- Queue abort 

• Device specific word for read/write = 30 (hexadecimal) 

Echo input character (echo mode) 

Line feed at end of message (EOM) 

• Detab is ON 

• Input is asynchronous 

• Output is asynchronous 

• Type is bidirectional 
STDnn 

• Record size: 81 bytes 

• Device specific word for connect/disconnect = 103 
(hexadecimal) 

No autodial is used 

Home cursor on page overflow 

- Leading control byte 

Logical poll interval = 1 second 
No space suppress 
No roll 

Hardware function codes are specified in write 
requests 

No timeout on read requests 

Send DLE EOT (Data Link Escape; End of Trans¬ 
mission) (7804) on disconnect 

Hang up phone on disconnect 
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DEVICE 


Queue abort 


• Device specific word for read/write = 10 (hexadecimal) 

- Carriage return at end of message 
Line feed at end of message 
Print one copy (7804) 

HASPnn 

• Record size: 520 bytes (including control bytes) 

• Device specific word for connect and disconnect = 0000 
(hexadecimal) 

- Queue abort 

- Hang up phone on disconnect 

• Device specific word for read/write = 0100 

- Leading control byte 

• Detab is ON 

• Input is synchronous 

• Output is synchronous 

• Type is bidirectional 

RCInn 

• Record size: 132 bytes (including control byte) 

• Device specific word for connect and disconnect = 0003 

- Do not hang up phone on disconnect 

- No queue abort 

• Device specific word for read/write = 0100 

- Do not quit upon receiving break 

- Leading control byte 

• Detab is ON 

• Input is synchronous 

• Output is synchronouo 

• Type is bidirectional 

1 rn 




The logical resource number of the station identified by 
the ATD, STD, TTY, VIP, BSC, PVE, HASP, or RCI directive 
with which this DEVICE directive is "paired." (A ROP is 
identified in a VIP directive.) The value of 1rn is an 
integer from 3 through 255. 
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level 


The priority level of the station identified by the ATD, 
STD, TTY, VIP, BSC, PVE, HASP, or RCI directive with 
which this DEVICE directive is "paired." 

The value for level is an integer from 7 through 61; it 
may be the same as the level specified for other communi¬ 
cations stations, but it must be a higher number than the 
communications interrupt level(s) specified in the COMM 
directive. The level specified for one or more communi¬ 
cations stations may not also be used for noncommunica¬ 
tions devices or tasks. 

X'channel' 

The channel number of the station identified by the ATD, 
STD, TTY, VIP, BSC, PVE, HASP, or RCI directive with 
which this DEVICE directive is "paired." Bits 10 through 
15 of the channel number specified in a DEVICE directive 
should equal 0 even though they may not equal 0 in the 
"paired" directive. Bits 15 and 16 of the channel number 
specified in a DEVICE directive do not indicate the 
interrupt level of the communications line. You can 
float this channel assignment by specifying a single zero 
(0) , if you wish. 

[ dev ice__name] 

A string of 1 to 12 ASCII characters, the first of which 
must be alphabetic. This device^name is a unique name by 
which the station can be referred to within the file 
system. If a device__name is not specified, the device__ 
unit argument is used as the dev ice__name. 

[ reco rd__si ze] 

The length, in bytes, of one physical record. If record__ 
size is not specified, the default record__size is as 
established by the device unit argument. 


For normally unbuffered stations (viz., BSC, HASP, RCI), 
B indicates that input/output to the station is to be 
buffered. 

For normally buffered stations (viz., TTY, VIP, PVE, 

ROP), N indicates that input/output to the station is to 
be unbuffered. 
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DEVICE 


For TTY, VIP, ROP, PVE, ATD, and STD stations, the 
default is buffered . For HASP, RCI, BSC, and XBSC sta¬ 
tions, the default is unbuffered . 

Input/output to a buffered station may be asynchronous 
or synchronous . Input/output to an unbuffered station 
is always synchronous ; tabulation characters are not 
expanded. 

For a BSC 3780 (XBSC) station, input/output must be 
asynchronous . Therefore, this argument must not be 
^peciTie3~as N for an XBSC station. 

For the following station types: 

TTY 

VIP 

PVE 

ROP 

ATD 

STD 

HASP 

RCI 

tabulation characters are normally expanded into space char¬ 
acters. Tabulation characters are not expanded if N is 
specified for these station types. Tabulation characters are 
never expanded for BSC or XBSC station types. 

Functional Description: 

If a communications station is to be accessible through the 
file system interface, the station's TTY, VIP, ATD, STD, BSC, 
PVE, HASP, or RCI directive must be "paired" with a DEVICE 
directive. The lrn, level, and channel numbers for each pair 
of directives must be identical. (Note that this requirement 
applies to an MLCP/DLCP-connected operator terminal.) 

Multiple DEVICE directives that specify the same lrn and 
level are invalid. The EQLRN directive (described elsewhere 
in this section) allows you to equate multiple lrn's for a 
device. 

Example 1: 

TTY 21,8,X'FF80' , , 300 

DEVICE TTY 00,21,8,X'FF80' ,TTYFILE 

In this example, a TTY is to be accessible through the file 
system interface. The DEVICE directive contains the same 
lrn, level, and channel number as the TTY directive. The 
default characteristics of the station are shown under the 
device unit argument above. The default record size (73 
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bytes) is also to be used since no record__size argument is 
specified in the DEVICE directive. The device name TTYFILE 
is to be used for references to the station within the file 
system. 

Example 2: 

SYS ... 


STDLN 10,X'FF00 ' ,2,2400,W4 

STD 20,0,V7805 

ROP ROSY26 

STD 21,1,V7804 

STD 22,2 

POLIST 2 

STAPOL 0,1,0,2 

DEVICE STD00,20,10,X'FF00',V7805,80,B 
DEVICE STD02,21,10,X'FF00' ,V7804,80,B 
DEVICE STD03,22,10,X , FF00',V7700,80,B 


In this example, three synchronous devices are to be access¬ 
ible through the file system interface. DEVICE STD00, 

DEVICE STD02, and DEVICE STD03 directives are paired with the 
first, second, and third STD directives in the CLM file. 

Note that each DEVICE directive has the same lrn, level, and 
channel number as specified in its paired STD directive. 
DEVICE directives may appear anywhere in your CLM file. 
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EQLRN DIRECTIVE 

Directive Name: EQLRN 

The EQLRN directive allows you to specify multiple logical 
resource numbers (lrn's) for the same physical device. 
Although each device in a communications configuration must 
be assigned a unique 1 rn, the EQLRN directive permits you to 
"equate" two or more lrn's to reference the same physical 
dev ice. 

Format: 

EQLRN lrn p ,lrn s [,lrn s ,...] 

Argument Description: 

1 rn p 


The primary logical resource number associated with the 
physical device. This argument must be specified. 

1 rn s 

The secondary logical resource number(s) that will be 
associated with .the device being referenced by lrn p . You 
must specify one or more lrn s arguments. Values you 
specify for 1rn s must be numerically less than the 
largest lrn used in a communications DEVICE directive or 
any other communications directive. 

The following example illustrates one possible applica¬ 
tion of the EQLRN directive: 

A communications device can be driven with two different 
sets of device characteristics via the saine user—written 
driver. Each different logical device is referenced by a 
unique file name. This requires two separate communica¬ 
tions DEVICE directives, each specifying a unique file 
name. The device characteristics are specified by STTY 
directives. 

The following set of CLM directives illustrate those 
directives which must be included at configuration time: 
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COMM 9 

LPH3 32,32,X'FF80' ,,4800 

DEVICE TTY05,32,32,X'FF80',CDR00,80 

STTY CDROO , ,X ' 0C00 1 , ,S 

DEVICE TTY06,33,32,X'FF80' ,CRP00,80 

STTY CRP00,,X'0800',OFF 

EQLRN 32,33 


ATD 35,35,X'FFOO' ,0,9600,'7200' 
DEVICE TTY07,35,35,X'FFOO',,,N 


Note that the last two directives above specify an lrn that 
is numerically larger than those specified in the EQLRN 
directive. The lrn 1 s specified in the EQLRN directive must 
be numerically less than the largest lrn specified in any 
other communications directive. 
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HASP DIRECTIVE 

Directive Name: HASP 

The HASP directive identifies an IBM workstation on a line 
serviced by the HASP line protocol handler. 1 

Format: 

HASP lrn,level,X'channel' ,[modeml 
Argument Description: 
lrn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


ilf the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the HASP directive (see "DEVICE Directive", earlier in this sec¬ 
tion). If input/output to the station is to be asynchronous, 
the B (buffered) argument must be included in the DEVICE 
directive. 
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X'channel' 

A four-digit hexadecimal number (from X'040n' to X'FF8n') 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data¬ 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem type (see "MODEM direc¬ 

tive", later in this section). 

The default value is modem type 2. 
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HASP 


H3270 


H3270 DIRECTIVE 

Directive Name: H3270 

The H3270 directive identifies a station on a line serviced 
by the BSC 3270 line protocol handler. Only one station may 
be configured on a line. 

Fo rmat: 

H3270 lrn,level f X'channel 1 ,[modem] ,X'poll_add ress' , 

X'selec t_add ress' 

lrn 


The logical resource number associated with the station. 
The value of lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 

X'channel' 

A 4-digit hexadecimal number (from X'040n' to X'FFftn 1 ), 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 
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Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


[modem] 

A number specifying the type of data set. Possible 
values are as follows: 


0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data¬ 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem type (see "MODEM 

Directive," later in this section). 


The default value is modem type 2. 

X'poll_address' 

A 2-digit hexadecimal number (from X'00' to X'FF') 
specifying the poll address of the 3270 control unit. 


X'select_address' 

A 2-digit hexadecimal number (from X 1 00' to X'FF') 
specifying the select address of a 3270 device. 


Example: 


H 3270 25,20,X'FC00',2,X'60' ,X'40' 

In this example the host will use an address of X'60' to poll 
this station and an address of X'40' to select this station. 
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H3270 



LPHn 


LPHn DIRECTIVE 


I 

I 


Directive Name: LPHn 


The LPHn directive 
a line serviced by 

Format: 


identifies the 
a user-written 


first (or only) station on 
line protocol handler. 1 


LPHn lrn f level, X'channel',[modem],[speed] 
[FDX/HDX][,lph specific word] 


name LPHn, 
a specific 
in 


In the directive 
3 and identifies 
-PHDEF directive is used 
tocol handler, the value 
directive must match n. 

Argument Description: 

lrn 


of 


n is an integer from 0 through 
line protocol handler. If an 
association with this line pro- 
the lph argument in the LPHDEF 


The logical resource 
The value for lrn is 
program may use this number 


number associated With the station, 
an integer from 3 through 255. A 
to identify the 


station when 


it requests an input/output operation to the station. 


level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


i The LPHn directive is also used in conjunction with the Remote f 

Batch Facility. See Appendix F. \ 
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X'channel 1 


A four-digit hexadecimal number (from X'040n' to 
X'FF8n')f specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


i 



[modem] 

A number specifying the type of data set. Possible 
values are as follows: 


0 - Direct connect. 

1 - Bell lxx-type modem (103A, etc.). Both data-set- 

ready and carrier-detect signals are needed for a 
connection; absence of both signals is a 
disconnect ion . 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data¬ 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem type (see "MODEM 

Directive," later in this section). 


The default value is modem type 2. 

[speed] 

The data rate in bits per second. 

For an asynchronous line with a communications-pac whose 
id is 2108 16 , use one of the following values for speed: 


50 

300 

2400 

75 

600 

3600 

(default) 110 

900 

4800 

134 

1200 

7200 

150 

1800 

9600 
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LPHn 


LPHn 


For an asynchronous line with a communications-pac whose 
id is 2100 16 , 2110 1g , or 2118 16 , use one of the following 
values for speed: 

50 200 1800 

75 300 2000 

(default) 110 600 2400 

134 1050 4800 

150 1200 9600 

NOTE: If the data rate is 134.5, specify 134. 

For asynchronous terminals you have the option to defer 
selection of the line speed until the terminal comes on¬ 
line. You select this option by specifying HI or LO. 

•HI' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 

•LO' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 

For more information about the line speed selection capa¬ 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 

[FDX/HDX] 

Specifies whether the line is full- or half-duplex. If 
it is full-duplex (FDX), two channel tables will be 
assigned. The default value is HDX. 

[lph_specific_word] 

A word containing user-defined information to be passed 
to the line protocol handler through the station table 
at offset ZQSSTS. The default is zero. 

Functional Description: 

The LPHn directive must be included once for each line (i.e., 
pair of channels) of an MLCP/DLCP on which there are stations 
to be driven by a user-written line protocol handler. An 
LDBU directive (described in Section 5) must be included 
among the CLM directives so that the Configuration Load Mana¬ 
ger will load the user-written line protocol handler bound 
unit and execute its initialization code. If the sizes of 
the channel and station tables are different from the default 
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sizes for these tables, an LPHDEF directive must be included 
before the related LPHn directive (s). The values specified 
in the LPHDEF directive apply only to the LPHn and STATION 
directives that immediately follow the LPHDEF directive in a 
CLM file. 

If there is more than one station on a line driven by the 
user-written line protocol handler, the additional stations 
on the line must be identified by STATION directives that 
immediately follow the LPHn directive (see "STATION Direc¬ 
tive," later in this section). 

Example: 


LPH 0 27,8,X'FD80',,,FDX 

STATION 28,1 

In this example, there are two stations on a synchronous, 
full-duplex line controlled by a user-written line protocol 
handler. 
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LPHn 



LPHDEF 


LPHDEF DIRECTIVE 


Directive Name: LPHDEF 


For each line protocol handler you write, you can include an 
LPHDEF directive to define the sizes of tables used for the 
channels and stations controlled by the line protocol han¬ 
dler. If the LPHDEF directive is not included, channel table 
and station table default sizes will be used for channels and 
stations controlled by the line protocol handler (see 
channel_table_size and station_table_size arguments below). 

Format: 

LPHDEF lph,[channel_table_sizel [,station_table_sizel 
Argument Description: 
lph 

An integer from 0 through 3 that associates this LPHDEF 
directive with a line protocol handler identified in one 
or more LPHn directives. 

[channel table size] 


Specifies the number of words needed for the channel 
table and the CQB's (communications queue blocks). It 
must have a value of at least 10 words. The default 
value is 33 words. 


[station table size] 


Specifies the number of 
tocol handler's station 
It must have a value of 
value is 10 words. 


words needed for this line pro¬ 
table (resource control table), 
at least 10 words. The default 


NOTE: The values specified for channel_table_size and 

station_table_si ze apply only to the LPHn and 
STATION directives that immediately follow the 
LPHDEF directive in a CLM file. 
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Example: 


LPHDEF 0,30 

LPHO 2 7,8,X 1 FD80', , , 

STATION 28,1 


FDX 


In this example, line FD80 has two stations on a synchronous, 
full-duplex line controlled by a user-written line protocol 
handler. Each of the two channel tables for the line has a 
size of 30 words, as defined by the channel_table_size argu¬ 
ment in the LPHDEF directive. The default value (10 words) 
is accepted for station table_size. 
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LPHDEF 



MODEM 



v,_y 


MODEM DIRECTIVE 


Directive Name: MODEM 

The MODEM directive defines a nonstandard modem type. The 
information provided in this directive is used to test 
entries in the appropriate line control table of the MLCP/ 
DLCP to verify a connection or disconnection. 


The MODEM command has a connect feature for some European 
data sets that require data-terminal-ready to remain low 
until the ring indicator is turned on. This feature is acti¬ 
vated by setting bit 7 of the data set control argument. 


Format: 


MODEM type_number,connection_AND_mask,connection_XOR_mask, 
disconnection_AND_mask,disconnection_XOR_mask, 
data set control 


Argument description: 
type_number 

An integer from 3 to 15 that is assigned to this modem 
definition and may then be used in a communications sta¬ 
tion directive (i.e., TTY, VIP, BSC, HASP, RCI, PVE, and 
LPHn directives) . 

connection_AND_mask 

A 2-digit hexadecimal number whose value governs which 
bits (i.e., from 0 through 3) of line register 5 (LR5) 
will be examined when a connect request is processed. 

connection_XOR_mask 

A 2-digit hexadecimal number whose value governs which 
bits (from 0 through 3) of LR5 must be ON (i.e., set 
to 1) for a connection. 
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disconnection_AND_mask 

A 2-digit hexadecimal number whose value governs which 
bits (i.e. f from 0 through 3) of LR5 will be examined 
when a disconnect request is processed or when a test for 
the occurrence of a disconnect is made. 

disconnection_XOR_mask 

A 2-digit hexadecimal number whose value governs which 
bits (from 0 through 3) must be ON (i.e., set to 1) for 
a disconnection. 

data_set_control 

A 2-digit hexadecimal number loaded into byte 20 of the 
appropriate line control table (LCT). The contents of 
LCT byte 20 are loaded into line register 2 of the 
communications-pac when a line is to be connected. 

NOTES: 1. To test for a successful connection , the contents 

of LR5 are first subjected to a logical AND 
operation against the (user-supplied) connection_ 
AND_mask; then a logical exclusive OR operation 
is performed on the result of the first opera¬ 
tion, against the (user-supplied) connection_XOR_ 
...ask. If the result is zero, a connection has 
been established. 


2. To test for a disconnect , the same operations are 
carried out using the analogous disconnection 
masks. A zero result indicates a disconnection. 


3. The following shows the mask and data set control 
values for the standard CLM-recognized modem 
types: 


Modem 

Type 

Type 

Number 

Connec tion 
AND 

Mask 

XOR 

Disconnection 

AND 

Masks 

XOR 

Data Set 
Control 

Direct 

Connect 

0 

X ' 80 ' 

X '80 ' 

X ' 80 ' 

X ' 00 ' 

X '88 ' 

Bell lxx 

1 

X *A0 ' 

X 'A0 ' 

A ' A0 ' 

X '00 ' 

X 

00 

o 

Bell 2xx 

2 

X ' 80 ' 

X 

00 

o 

o 

00 

X 

X ' 00 ' 

X ' 80 ' 


Line register 5 and byte 20 of the LCT are shown below. 

See the Communications Handbook for a detailed description] 
of these entities. 
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MODEM 



MODEM 


Line Register 5: 


0 

_ 1 _ 1 

_ 2 _ 1 

3 

4 

5 

6 

7 

DATA SET STATUS 

COMMUNICATIONS"?AC STATUS 

DATA SET 
READY 

CLEAR 

TO SEND 

CARRIER 

DETECTOR 

RING 

INDICATOR 

ASYNCHRONOUS 

CHANNEL 

RECEIVE 

RESERVED 

RECEIVE 

OVERRUN 

ASYNCHRONOUS 

FRAMING- 

ERROR 





SYNCHRONOUS 
RESERVE!) — 



SYNCHRONOUS 







TRANSMIT 

UNDERRUN 


LCT Byte 20: 

_0 _j_ 1 _|_ 2 _j_ 3_|_4_I_5_|_6_|_7 


DATA SET CONTROL 

COMMUNICATIONS*?AC CONTROL 

DATA 

" TERMINAL 
READY 

REQUEST 

TO SEND 

ga ws 

CHANNEL 

TRANSMIT 

SHF 

ASYNCHRONOUS 

TRANSMIT' . 

SPACE 

ifcNCHHONOUg 

SELECT 

ASYNCHRONOUS 

TRANSMIT 

MARK 

CONNECT 

LOOP 

BACK 

TEST 

RECEIVE 

ON 

TRANSMIT 

ON 


Example 1: 

MODEM 3,X'20',X'20',X'20,X'00',X'88' 

In this example, a modem type requiring only the carrier- 
detect signal for a connection and absence of this signal 
for a disconnection is defined. 

Example 2: 


MODEM 4,X'90',X'90,X'90',X'00',X'81' 

This example illustrates a MODEM directive for a European 
modem that is like a Bell Type 103, except for the relation¬ 
ship between data terminal ready and the ring indicator. 


,,4f r ' 

V_y 
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POLIST 


POLIST DIRECTIVE 


Directive Name: POLIST 

POLIST specifies the time interval between successive scans 
of the poll list. The POLIST directive must precede the 
poll list. 

Format: 

POLIST [poll_cycle_delayl 
Argument Description: 


[poll_cycle_delay] 


Defines the time interval in seconds 
scans of the poll list. After comple 
poll list the driver waits the specif 
before re-scanning the poll list. If 
specified, it must be in the range of 
If not specified, the default is 1 (s 


between successive 
ting a scan of the 
ied time interval 
this parameter is 
1 to 10 (seconds) . 
econd) . 
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PVE 


PVE DIRECTIVE 

Directive Name: PVE 

The PVE directive identifies a polled VIP or STD emulated 
station on a line serviced by the VIP or STD line protocol 
handler . ’. 2 , 3,4 

Format: 

PVE lrn,1evel,X'channel' ,[modem] ,poll_addressf,poll_response] 
[,controller_poll_address] 

Argument Description: 


The logical resource number associated with this station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


1 PVE directives are used in configuring the system at the end of 
the communications line where polled VIP emulation is to be per¬ 
formed. The system at the other end of the communications line 
must be configured with a VIP directive for each PVE directive; 
the poll address in each pair of directives must be the same. 

2 A single communications line can have up to 32 polled VIP sta¬ 
tions. The total of 32 may be achieved by any combination of 
actual VIP stations or emulated stations. At your option, up to 
32 stations may be combined in groups of 8 whe«n emulating a 

VIP 7760 line. All stations in a group must specify the same 
controller poll address, as if they were connected to one VIP 
7760 controller. 

3 If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the PVE directive (see "DEVICE Directive," earlier in this 
section). 

4 A station can consist of up to 3 addressable components (screen/ 
keyboard, ROP, and/or cassette). 
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level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. The level of all PVE 
stations on a common MLCP/DLCP channel must be the 
same. 



X'channel' 

A four-digit hexadecimal number (from X'040n' to 
X'FF8 n'), specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 


rmodem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem (see "MODEM Directive" 

earlier in this section). 

The default is modem type 2. 
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PVE 



PVE 


poll_add ress 

Specifies the poll_address of this station on the line 
identified by the channel argument. The poll_address 
argument is an integer from 0 through 31. Each station 
on the line must have a unique poll_address. 

[poll_response] 

Specifies the type of response that PVE will generate if 
a select and/or poll is received for a station that is 
not logically connected. The possible values are: 

QA - If a non-connected station is selected to 

receive data, PVE will respond to the subsequent 
poll with a positive acknowledgement (ACK). 

If a non-connected station is simply polled, PVE 
will respond with a quiescent (Q) frame. 

QN - If a non-connected station is selected to 

receive data, PVE will respond to the subsequent 
poll with a negative acknowledgement (NAK) . 

If a non-connected station is simply polled, PVE 
will respond with a quiescent (Q) frame. 

Default: No response to poll. 

[controller_poll_address] (VIP 7760 only) 

The controller poll address associated with this station 
on the line; it equals the poll address of the VIP 7760 
controller to which this station is connected. This sta¬ 
tion emulates a VIP 7760 station having the same control¬ 
ler poll address. controller_poll_address must be an 
integer ranging from 0 through 7. Several stations on 
the line may have the same controller poll address. 

Default: No controller poll address is assigned for this 

station. 

Example: 

PVE 30,9,X'FD80' , , 0 
PVE 31,9,X'FD80',,1 
PVE 32,9,X'FD80',,2 

In this example, three polled VIP emulated stations are 
defined for a communications line (FD80). Each station has a 
unique lrn and poll_address. The default value (2) is estab¬ 
lished for modem type. 
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The system at the other end of the communications line must 
be configured with VIP directives for the same physical 
line; each poll_address in a PVE directive (in system "A") 
must be matched by a poll_address in a VIP directive (in * 

system "B"). 
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RCI 


RCI DIRECTIVE 


Directive Name: RCI 

The RCI directive identifies a station on a line serviced by 
the Remote Computer Interface (RCI) line protocol handler. 1 

Format: 

RCI lrn,1evel,X'channel',[modem) 

Argument Description: 

1 rn 

The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but is must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. the level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 


i If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the RCI directive (see "DEVICE Directive", earlier in this sec¬ 
tion). If input/output to the station is to be asynchronous, 
the B (buffered) argument must be included in the DEVICE 
direc tive . 


V. ,y 


.4 T \ 

4j 
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X 1 channel' 

A four-digit hexadecimal number (from X'040n' to X'FF8n') 
specifying the channel number of the station and the 
interrupt priority level (n) of the line. The channel 
number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A,208B, etc.). the data- 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem type (see "MODEM Direc¬ 

tive", earlier in this section). 

The default value is modem type 2. 
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RCI 


ROP 


ROP DIRECTIVE 

Directive Name: ROP 

The ROP directive specifies that a receive-only printer (ROP) 
is connected to a station on a line serviced by the STD line 
protocol handler. (See the STDLN directive for information 
on how to specify ROP directives in a CLM file.) 

Fo rmat: 


ROP rop__type 

Argument Description: 
ro’p__type 

Specifies the type of receive-only printer device that is 
connected to the station. Possible values for this argu¬ 
ment are: 


corresponding 


levice 


1003 PRU1003 

1005 PRU1005 

TN300 TermiNet 300 

TN1200 TermiNet 1200 


One value for rop type must be specified. 
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STAPOL DIRECTIVE 

Directive biame: STAPOL 

The STAPOL directive defines the order in which stations are 
polled on a line serviced by the STD line protocol handler. 
The order in which stations are polled is determined by the 
position of arguments in the STAPOL directive. (See the 
STDLN directive for examples.) 

Format: 

STAPOL station_poll_address [,station_poll_address 2 ] 
.[ ,station_poll_address 15 ] 

Argument Description: 

station_poll_address n 

Specifies the poll address of a station on this line. 

Up to 15 station poll addresses may be specified. The 
station poll addresses must have been previously speci¬ 
fied in the STD directive associated with this line. The 
value of this argument must be in the range 0 through 31. 
It may be specified as many times as is necessary to cre¬ 
ate the polling priority list for the line. 
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STATION 


STATION DIRECTIVE 


Directive Name: STATION 

The STATION directive identifies the second or subsequent 
station(s) on a line controlled by a user-written line proto¬ 
col handler that drives multiple stations per line. One sta¬ 
tion on the line must be identified by an LPHn directive; 
additional stations are identified by STATION directives, one 
per station, immediately following the related LPHn direc¬ 
tive. 1 (See the LPHn directive for an example.) STATION 
directives and LPHn directives must immediately follow the 
LPHDEF directive that defines them in a CLM file. 

Format: 

STATION lrn [ , lph__spec i f ic__wo rd] 

Argument Description: 

1 rn 


The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

[ lph__spec i f ic__wo rd] 

Specifies a word containing user-defined information that 
is to be passed to the line protocol handler through the 
station table, at offset ZQSSTS. The default is 0. 

NOTE: The priority level, channel number, modem type, line 

speed, and line procedure (FDX/HDX) of stations 
described in STATION directives are obtained from the 
LPHn directive that precedes the STATION directive 
(see "LPHn Directive", earlier in this section). 


'For additional (polled) VIP's on a line, use additional VIP 
directives with the same level and channel number, rather than 
STATION directives. 
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STD 


STD DIRECTIVE 1 


Directive Name: STD 

The STD directive identifies a station on a line serviced 
by the synchronous terminal device (STD) line protocol han¬ 
dler. See the STDLN directive for examples. 

Fo rmat: 

STD lrn ,station__poll__address [ , ,dev ice__type] 

Argument Description: 
lrn 

The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

stationjpo Headdress 

Specifies the poll address of this station. The poll 
address is an integer from 0 through 31. Each station 
on the line must have a unique station__poll__address. 

[ dev ice__type] 

Specifies the type of VIP terminal used. Possible values 
for device__type are: 


iThe STD directive and the VIP directive support synchronous 
terminals. The line protocol handler called by the STD direc¬ 
tive offers additional support capabilities (e.g., support of 
VIP7804 and VIP7805 terminals) not offered by the line protocol 
handler called by the VIP directive. 
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STD 


dev ice__type 

V7804 

V7700 

V7760 


corresponding 
terminal type 

VIP 7804/VIP 7805 

VIP 7700/VIP 7700R/VIP 7705R 

VIP 7760 


If this argument is not specified, the default device__type 
is V7700. 

When using the Synchronous Terminal Driver (STD) line proto¬ 
col handler, you must observe the following: 

• The master LRN station must be the last station to be 
disconnected. 

• The 7804 Control Byte Head of Form support translates to a 
7804 clear escape sequence. This sequence, in addition to 
positioning the cursor to the Home row, puts the 7804 in 
text mode. 

• To use the STD LPH, the VIP 7804 hardware switches must be 
configured as follows: 

Reset, Text Mode, Verify before process. 

Transmit next block. 

Optional settings are: 

Roll/No Roll 

Space/No Space 

Return = Transmit/Normal 

Set Block Size 

• VIP 7804 terminals are not compatible with VIP7700 termi¬ 
nals in the handling of end-of-message CR's and LF's. It 
is recommended that the new STD line protocol handler be 
used for VIP7804 support. If the VIP line protocol hand¬ 
ler is used to support a VIP7804 terminal, the following 
must be observed: 

1. RETURN=NORMAL must be selected at the terminal. 

2. The XMT key should be used to enter commands. 

3. When using the Editor, Linker, or other utility direc¬ 
tives with the prompt option, the RETURN key should be 
depressed before the SMT key. This will assure that 
the prompt appears on the next line rather than at the 
end of the current line. 


4 ' 


t " 
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STDLN DIRECTIVE 

Directive Name: STDLN 

The STDLN directive identifies a line serviced by the STD 
line protocol handler. (The STDLN directive does not support 
floating channel number assignments. You must explicitly 
specify the channel number argument.) 

Fo rmat: 

STDLN level,X'channel 1 ,[modem] ,[speed] [,2/4 wire] 

Argument Description: 
level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value of the level is an integer from 8 
through 58; it may be the same as the level specified 
for other communications stations, but it must be a 
higher number than the communications interrupt level(s) 
s' p ecTF i ed'in the" ~COMM directive. The level specified for 
one or more communications stations may not also be used 
for non-communications devices or tasks. 

X'channel' 

A four-digit hexadecimal number (from X'040n' to 
X'FF8 n')f specifying the channel number of the station 
and the interrupt priority level (n) of the line. The 
channel number has the following format: 


Bits 

0 

through 9 - 

The 10-bit 
or receive 

channel 

channel 

address of the 
on the line. 

send 

Bits 

10 

through 13 

- Must be set to zero. 


Bits 

14 

through 15 

- Specifies 

n, the 

priority level 

at 


which a communications line inter¬ 
rupts the central processor. n may 
have a value of 0,1,2, or 3 as 
specified in the COMM directive. 

See the description of the COMM 
directive for further information. 
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[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 

set-ready signal is needed for a connection; absence 
of this signal is a disconnection. 

3 or greater - User-defined modem (see "MODEM Directive," 

in this section). 

The default is modem type 2. 

[speed] 

The data rate in bits per second. The default value is 
2000. Other possible values for speed include: 

2400 

4800 

9600 

19200 

[2/4 wire] 

Specifies a 2 or 4 wire connection. Possible values are: 


value 

meaninc 

l 

(default) W2 

2 -wire 

connection 

W4 

4-wire 

connection 


Functional Description: 

The STDLN directive defines a line serviced by the STD 
line protocol handler; it precedes all other directives 
which characterize this line. Configuring a line ser¬ 
viced by the STD line protocol handler requires that at 
least four different directives be specified for the line 
and all stations on the line. These directives must be 
specified according to the following guidelines: 


Required directives 


STDLN (specify one for each line) 

STD (specify one for each station on the line) 
POLIST (specify one for each line) 

STAPOL (specify one or more as needed) 


rf 

V 
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Optional directive 
ROP 


Sequence rules 

The following diagram illustrates the sequence rules that 
apply when specifying STDLN and other STD directives. One 
set of these directives must be specified for each line. 
Note that all directives which characterize the line must 
immediately follow the STDLN directive that identifies the 
line. Brackets enclose optional directives. 

STDLN must specify one for each line 

STD, 

[ROP] specify one for each 
station, if needed 

STD 2 
[ROP] 


POLIST must specify one for each line 

STAPOL must specify one or more 

for each line; all STAPOL 
directives should be specified 
in the order in which stations 
are to be polled 


specify one set for each 
station on the line; all must 
precede POLIST 


Example 1: 


• 

STDLN 20,X'FC00',,2400,W4 

STD 20,1,,V7804 

ROP TN 300 

STD 21,2,,V7804 

ROP ROSY26 

STD 22,3 ,,V7804 

POLIST 5 

STAPOL 1,2,1,3 


In this example, an STD line has been configured with three 
stations. As specified in the STDLN directive, this line's 
request level is 20, the channel number is FC00, the default 
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modem used is type 2, the line speed is 2400 bits per second, 
and the line connection is 4-wire. All three stations sup¬ 
port VIP7804 terminals. The first station has an lrn of 20, 
a poll address of 1, and includes a TN300 ROP. The second 
station has an lrn of 21, a poll address of 2 and includes a 
PRU 1005 ROP. The third station has an lrn of 22, a poll 
* address of 3 and no ROP. The POLIST directive identifies the 
start of the poll list and specifies a 5-second delay between 
successive poll list scans. This STAPOL directive specifies 
that the station with poll address 1 (lrn 20) is polled twice 
as often as the other two stations, implying that this static 
has higher priority. 

Example 2: 

SYS . 


STDLN 10,X'FF00',2,2400,W4 

I STD 20,0,V7805 

ROP ROSY26 
STD 21,1,V7804 
STD 22,2 
POLIST 2 
STAPOL 0,1,0,2 

I DEVICE STD00,20,10,X'FF00 I ,V7805,80,B 

DEVICE STD02,21,10,X'FF00',V7804,80,B 
* DEVICE STD03,22,10,X 1 FF00',V7700,80,B 


The above example describes an STD line connected to the 
system through address "FF00", with an interrupt level of 10. 
The line uses a type "2" modem at 2400 baud and is a 4-wire 
connection. There are three VIP's on the line. The termi¬ 
nals will be polled in the following sequence for data: 

* 0,1,0,2; after which there will be a delay of two seconds 
before they are polled for data again. Address "0" will be 
polled twice as frequently as the other two terminals. All 
of the devices are configured for the file system, as shown 
in the DEVICE directives. (The DEVICE directives may appear 

* anywhere in your CLM file.) 
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STTY DIRECTIVE 


Directive Name: STTY 


The STTY directive specifies the file characteristics of a 
device that is not a disk device or a private device. The 
characteristics specified by this directive override the 
default characteristics established by the associated DEVICE 
directive (or the characteristics established by a previous 
STTY directive). The STTY command keyword format (as 

D) may be used as an alternative to the 
in your CLM filej 


described in Appendix 
STTY directive format 


Format: 


! dev ice__uni t 
dev ice__name, 


[length] ,[D 1 dsw 1 dsw 2 '],[detab],[in] , 
[out] [ , type] 


Argument Description: 

! dev ice__unit t 
device__name ( 

This entry, which identifies the device, must be the 
same as one entered in a previous DEVICE directive. If 
device__name was specified in a previous DEVICE directive, 
it must be entered here; i.e., the entry of device__unit 
will result in error. The device__unit and device__name 
arguments each consists of a string of ASCII characters 
as described under the DEVICE directive. If there is no 
previous DEVICE directive having the string specified 
here, an error message is generated. 

[ length] 

An integer giving the line length (record size) in bytes. 


lYou must use the STTY command format in your CLM directive file 
if you wish to configure a device that can be automatically 
reconnected if a power resumption or line drop condition occurs, 
See Appendix D for information on how to configure devices as 
reconnectable. The STTY command format is described in 
Appendix D. 
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[D ' dsw, dsw 2 ' ] 

Specifies the terminal's device specific words for 
connect/disconnect (dsw 1 ) and read/write (dsw 2 ). The 
values of dsw-, and dsw 2 are expressed in double-word for¬ 
mat as a pair of 4-character hexadecimal numbers enclosed 
in apostrophes. 

dsw 1 specifies certain characteristics of a device at 
open (connect) or close (disconnect) time, as shown in 
Tables 6-4 and 6-6. Refer to these tables when defining 
the 16-bit settings for dsw, that characterize connect/ 
disconnect functions. 

dsw 2 specifies certain characteristics of a device when 
reading or writing to a file, as shown in Tables 6-5 ana 
6-6. Refer to these tables when defining the 16-bit set¬ 
tings for dsw 2 that characterize read/write functions. 

If dsw! and dsw 2 are not specified, certain default val¬ 
ues are assumed. Default values are listed in Table 6-7. 

NOTE: The STTY command keyword format (as described in 

Appendix D) may replace the STTY directive format 
in your CLM file. When used at CLM time, either 
STTY format will cause the initial dsw! and dsw 2 
assignments (as well as the current device speci¬ 
fic word assignments) to be modified. However, if 
the STTY command is specified at any time after 
system initialization, only the current device 
specific word assignments will be modified. Only 
at system building (CLM) time will the STTY direc¬ 
tive format or the STTY command keyword format 
modify both the current and the initial device 
specific word assignments. 1 

[detab] 

An alphabetic string that controls tabulation 

-ON Tab characters in the input stream are deleted and 
replaced by the number of spaces required to bring 
the cursor (or printer) to the next tab position. 

Tab positions are set by the MOD 4(f0 system in 
increments of 10 (to print positions 11, 21, 31,...) 
and cannot be changed by the user. 

-OFF Tab characters in the input stream are not replaced 
by spaces. 


iIn a diskette-based system, using the STTY command format in 
your CLM file results in the loader error 1609. If you wish to 
use the STTY command format in your CLM file, you must create a 
directory under the system root named SYSLIB2 and load in it the 
bound unit SSTY. 
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[in] 


An alphabetic character specifying the type of input 


accepted by 

the device 

• 




A - The 

dev ice 

is 

to 

receive 

asynchronous 

input 

S - The 

device 

is 

to 

rece ive 

synchronous 

input 

N - The device 
input 

is 

to 

receive 

nonbuffered 

synchronous 


[out] 

An alphabetic character specifying the type of data 
transmitted by the device 

A - The device transmits asynchronous output 

S - The device transmits synchronous output 

N - The device transmits nonbuffered synchronous 
output 


[type] 

An alphabetic character specifying the device type 

I - The device is an input device 

0 - The device is an output device 

B - The device is bidirectional; it receives and 
transmits 

Messages 


Error messages 

that 

may be 

directive 

a re 

as follows: 

133E 

CMD 

(STTY) 

ERROR. 

133F 

CMD 

(STTY) 

ERROR. 

1341 

CMD 

(STTY) 

ERROR. 

1342 

CMD 

(STTY) 

ERROR. 


issued during execution of this 


No previous DEVICE directive. 
Invalid detab argument. 
Invalid in or out argument. 
Invalid type argument. 


Device Specific Words for Communications Devices 


Table 6-4 lists the bit settings for dsv^ , the device 
specific word for connect/disconnect functions. Table 6-5 lists 
the bit settings for dsw 2 , the device specific word for read/ 
write functions. Use these tables in conjunction with Table 6-6 
to determine the definitions of each bit. 
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If you do not wish to specify dsw-, and/or dsw 2 in the STTY 
directive, the system assumes certain default values for them. 
Refer to Table 6-7 for a list of device specific word defaults 

Table 6-4. Values for dswi 


Function 


CONNECT 








Bit 

Position 






LPH 

0 

i 

2 

3 

4 

5 

6 

7 

8 

9 

10 

ii 

12 

13 

14 

15 

TTY 

0 

0 

D 

0 

X 

0 

0 

0 

0 

0 

0 

0 

0 

z 

0 

0 

VIP 

R 

R 

D 

W 

X 

P 

P 

P 

F 

0 

0 

0 

0 

0 

0 

0 

BSC 

0 

0 

D 

0 

X 

s 

0 

q 

B 

G 

0 

0 

0 

0 

0 

0 

PVE 

0 

0 

D 

0 

0 

0 

0 

0 

F 

0 

V 

0 

0 

0 

w 

X 

ATD 

a 

0 

D 

0 

0 

0 

b 

0 

c 

d 

u 

0 

0 

0 

0 

0 

STD 

m 

0 

D 

W 

I 

P 

P 

p 

J 

K 

N 

F 

e 

y 

0 

0 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


DISCONNECT 

TTY 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


VIP 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


BSC 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


PVE 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


ATD 

n 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


STD 

0 

U 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

A 

H 


Table 6-5. Values for dsw 


Function 


READ 








Bit 

Position 






LPH 

0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

TTY 

0 

0 

0 

0 

0 

M 

0 

0 

Y 

0 

E 

L 

C 

0 

0 

0 

VIP 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

BSC 

0 

0 

0 

0 

0 

0 

0 

0 

0 

G 

0 

0 

0 

0 

0 

0 

PVE 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

ATD 

f 

0 

0 

0 

0 

0 

0 

Q 

0 

0 

E 

L 

C 

0 

0 

0 

STD 

g 

0 

0 

0 

X 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 


WRITE 


0 0 


M T 0 0 
0 0 0 0 
C 0 0 0 
C k k k 
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Table 6-6. Bit Definitions 


BIT If bit = 0: 

If bit = 1: 

A 

Dequeue remaining IORB's 
for channel 

Don't dequeue remaining IORB's 
for channel 

a 

Block mode not supported 

ATD Block mode supported 

B 

Buffer mode is single-block 

Buffer mode is double-block. 
(Note: Double-block is not sup¬ 
ported by file manager) 

b 

ETX mode (ATD Block mode 
only) 

ETB/ETX specified on write (ATD 
Block mode) 

C 

Send CR after text of mess¬ 
age (Not supported for 
supervisory message reads 
by ATD) 

Don't send CR after text of 
message 

c 

No space suppress 
(VIP 7801) 

Space suppress (VIP 7801) (Only 
applicable in block mode) 

D 

No Auto-dial used 

Use Auto-dial handler to dial 
connection 

d 

Roll (VIP 7801) 

No roll (VIP 7801) 

E 

Don't echo input characters 

Echo input characters 

e 

No time-out for read 

Time-out for read (immediate) 

F 

Don't save in read IORB 
function codes received in 
text header 

Save up to 2 function codes 
received in text header 

f 

Don't abort read IORB 
requests (ATD) 

Abort read IORB requests (ATD) 

G 

Use BSC2780 protocol 

Use 3780 protocol 

g 

Don't abort read/write 
requests 

Abort read/write requests 

H 

Hang up the phone on dis¬ 
connect 

Don't hang up the phone on dis¬ 
connect (ATD Block mode) 

h 

Don't abort write IORB 
requests (ATD) 

Abort write IORB requests (ATD) 

I 

Control word present for 
read/write 

No control word for read/write 
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Table 6-6 (cont) 


BIT If bit = 0: 

i Don't support preemptive 
write 

J Don't set VIP 7804 CRT 
space suppress 

j Send a block ended by ETX 

K Set VIP 7804 CRT roll mode 

L Don't send LF after text of 
message (Not supported for 
supervisory message reads 
by ATD) 

M Data mode is non¬ 
transparent 

m Don't set VIP 7804 CRT to 
block mode (RECV) 

N Set transparent printer 
mode 

n Not reserved for cross¬ 
compatibility with STD lph 

Q Quit on receiving break 
(Not supported for super¬ 
visory message writes by 
ATD) 

q Buffer mode is not multi¬ 
block 

S Don't send EOT characters 

s Don't support DLE EOT 

T Send ITB and ETB characters 

t Include control byte 

U Don't send DLE EOT for 
VIP 7804 

u No echoplex (VIP 7801) 

V Don't send RVI characters 


. Bit Definitions 
If bit = 1: 

Support preemptive write (ATD 
Block mode only) 

Set VIP 7804 CRT space suppress 

Send a block ended by ETB 
Don't set VIP 7804 CRT roll mode 
Send LF after text of message 


Data mode is transparent 

Set VIP 7804 CRT to block mode 
(RECV) 

Set non-transparent printer mode 

Reserved for cross-compatibility 
with STD lph 

Don't quit on receiving break 

Buffer mode is multi-block 

Send EOT characters 
Support DLE EOT 
Send ETX characters 

o 

Do not include control byte 
Send DLE EOT for VIP 7804 

Echoplex (VIP 7801) 

Send RVI characters 


t 


V- 
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BIT If bit 


0 : 


Table 6-6 (cont) . Bit Definitions 


c/> 

H 
—I 
-< 


v Include received DEL 
characters in buffer 

W Home cursor on page over¬ 
flow 

X Include control byte as 
first byte 

Y Include ATTENTION character 

y Return key equal transmit 
key 

Z Transfer mode is character 


I 


P Logical Poll interval 

000 = 0 sec 010 = 2 sec 100 = 4 sec 110 = 15 sec 
001 = 1 sec 011 = 3 sec 101 = 5 sec 111 = 30 sec 

R Logical read time-out interval (poll duration): 

00 = 10 min 01 = no time-out 10 = 0 min 11 = reserved for 

future use 


w,x LPH response to application when LPH receives data but no 
real IORB available. VIP status codes: 

00 = Send NAK 10 = Return busy status 

01 = Send ACK 11 = Send NAK (same as 00) 

NOTES: 

1. 0 indicates that you cannot use the bit. 

2. This table is organized by function for convenience only; 
there is no overlapping of bits, dsw, sets all bits for 
connect/disconnect functions. dsw 2 sets all bits for 
read/write functions. 


k VIP 7804/5 Printer copy 


000 = 1 

copy 

010 = 3 

copies 

100 = 5 

copies 

110 = 7 

copies 

001 = 2 

copies 

Oil = 4 

copies 

101 = 6 

copies 

111 = 8 

copies 


If bit = 1: 

Strip received DEL characters 

Don't home cursor on page 
overflow 

No control byte (first byte is 
data) 

Exclude ATTENTION character 
No specific meaning to return key 

Transfer mode is page 
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Table 6-7. System Defaults for dsw t and dsw 2 


Device 

dsw-i 

dsw 2 

TTY 

0000 

0030 

VIP 

0000 

0110 

ROP 

0000 

0000 

BSC 

0000 

0000 

PVE 

0000 

0000 

XBSC 

0000 

0040 

ATD 

0000 

0030 

STD 

0103 

0010 


/f N 
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TTY DIRECTIVE 1 


Directive Name: TTY 


The TTY directive identifies a station on a line serviced by 
the TTY (teleprinter) line protocol handler. The TTY direc¬ 
tive supports asynchronous terminal devices as teleprinter- 
compatible devices. You may float the channel assignment in 
this directive, if you wish. 

Format: 

TTY 1rn,level,X'channel' ,[modem],[speed 1 T,'dev ice-type'1 

Argument Description: 

lrn 


The logical resource 
The value for lrn is 
program may use this 


number assoc 
an integer f 
number to id 


it requests an input/output opera 


iated with the station, 
rom 3 through 255. A 
entify the station when 
tion to the station. 


I 


iThe TTY directive and the ATD directive support asynchronous 
terminal devices. The line protocol handler called by the TTY 
directive supports the physical terminal only in teleprinter 
mode. The TTY line protocol handler does not provide block mode 
support of VIP7800 devices; neither does it provide support for 
VIP7200 devices and VIP7800 devices in forms processing mode. 
(For these functions the ATD directive is required.) The ATD 
line protocol handler does not provide the transparent read I/O 
or single character mode functions of the TTY line protocol 
handler. The number of words of resident memory required by the 
TTY line protocol handler is less than the number of words of 
resident memory required by the ATD line protocol handler. See 
the MOD 400 Executive Software Release Bulletin for comparative 
figures. 
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level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value of level is an integer from 7 through 
61; it may be the same as the level specified for other 
communications stations, but it must be a higher number 
than the communications interrupt level(s) specified in 
the COMM directive. The level specified for one or more 
communications stations may not also be used for non¬ 
communications devices or tasks. 

X'channel' 

You may specify a single zero(O) to float the channel 
number assignment or a four-digit hexadecimal number 
(from X'040h' to X'FF8n'), that specifies the channel 
number of the station and the interrupt priority level 
(n) of the line. The channel number has the following 
format: 

Bit 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

1 - Bell lxx-type modem (103A, etc.). Both data-set- 

ready and carrier-detect signals are required for a 
connection; absence of these signals is a 
disconnection. 

3 or greater - User-defined modem type (see "MODEM Direc¬ 
tive," earlier in this section). 

The default value is modem type 1. 


A.. 
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[speed] 


The data rate in bits per second. 

For an asynchronous line with a communications-pac whose 
id is 2108 )6 , use one of the following values for speed: 

50 300 2400 

75 600 3600 

(default) 110 900 4800 

134 1200 7200 

150 1800 9600 

For an asynchronous line with a communications-pac whose 
id is 2100 16 , 2110 16 , or 2118 16 , use one of the following 
values for speed: 

50 200 1800 

75 300 2000 

(default) 110 600 2400 

134 1050 4800 

150 1200 9600 

NOTE: If the data rate is 134.5, specify 134. 

You have the option to defer selection of the line speed 
until the terminal comes online. You select this option 
by specifying HI or LO. 

'HI' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 

' LO' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 

For more information about the line speed selection capa¬ 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 

['dev ice-type'] 

Specifies the type of terminal used. If this argument is 
not specified, the default is TTY. Possible values are: 
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All 


Value 

Physical 

devices supported 

7200 

VIP 7200, 

VIP 7205 

7801 

VIP 7801, 

VIP 7802 

PRU 

PRU 1001, 
TWU 1001, 

PRU 1003, PRU 1005, 
TWU 1003, TWU 1005 

TTY 

An asynchronous terminal that 


is to be suported as teleprinter- 
compatible 

Example 1: 

TTY 21,8 , X 1 FF80' 

DEVICE TTY 01,21,8,X'FF80' ,TTY 1 

In this example, the TTY is connected by a Bell lxx-type 
modem and operates at 110 bits per second. Default values 
for modem type and line speed have been used. The TTY is to 
be accessible through the file system interface (by virtue of 
the DEVICE directive). 

Example 2: 


TTY 22,8,X'FF00',0,1200 

DEVICE TTYO 2,22,8,X'FF00',TTY 2 

In this example, the TTY is connected by a direct cable con¬ 
nection and operates at 1200 bits per second. These charac¬ 
teristics are reflected by explicit arguments in the TTY 
directive. Again, the TTY is to be accessible through the 
file system interface. 


4 
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VDAM DIRECTIVE 


Directive Name: VDAM 

The VDAM directive must be specified if the Display Formatt¬ 
ing and Control software is to be used. This directive 
causes the software component to be incorporated in the 
configuration. 1 You must configure the Display Formatting and 
Control Software if your installation will support DEF-II or 
DEF-II and TCLF. See Appendix P for further information on 
configuring the Display Formatting and Control Software. 

Fo rmat: 

VDAM [ lrn , level ][ ,max imum terminals] 

Argument Description: 
lrn 

The logical resource number associated with the VDAM 
task. The value for lrn is an integer from 3 through 
255. This value must be specified if asynchronous VDAM 
processing is desired. The next two sequential lrns will 
be reserved for VDAM processing. 

level 

The priority level at which VDAM processing operates. 

The value for level must be an integer from 7 through 61. 
This value must be specified if asynchronous VDAM proces¬ 
sing is desired. 

NOTE: Both lrn and level must be specified, or neither 

argument should be specified. If neither one is 
specified, the default is that no asynchronous 
instructions are issued to VDAM. 


i Display processing requires VIP 7200/7205 or VIP 7801/7802 
terminals. The terminals can be configured using an ATD or a 
V7200 directive. 
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[maximum terminals] 

The maximum number of terminals that use VDAM processing 
in one task group. If a number is not specified, the 
default value is 10. 
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VIP DIRECTIVE 

Directive Name: VIP 


The VIP directive identifies a polled or nonpolled visual 
information projection station on a line serviced by the 
VIP line protocol handler. Optionally, the VIP directive 
identifies a ROP (receive-only printer) station on the same 
line .12,3,4 VIP 7700, VIP 7700R/7705R, VIP 7804/7805 (in 
VIP7700 mode) and VIP 7760 terminals are supported. You may 
float channel assignments in this directive, if you wish. 

Format: 


VIP 1rn,level,X'channel',[modeml,(poll_addressl, 
[R0P_lrn] ,[R0P_type] [,ROP_form_feed 1 



} 


1 The VIP directive and the STD directive both support synchronous 
terminals. The line protocol handler called by the STD direc¬ 
tive offers additional support capabilities (e.g., support of 
VIP7804 and VIP7805 terminals) not offered by the line protocol 
handler called by the VIP directive. 

2 1f the Configuration Load Manager detects an error in a VIP 
directive, the error must be corrected in the CLM_USER file and 
the system bootstrapped again. 

3 If the station is to be accessible through the file system 
interface, an appropriate DEVICE directive must be "paired" with 
the VIP directive (see "DEVICE Directive," earlier in this 
section) . 

4 If a "remote" system is to perform polled VIP emulation, see 
"PVE Directive," earlier in this section, for a description of 
the relationship between VIP directives for the "local" system 
and PVE directives for the "remote" system. 
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Argument Description: 

fT 

lrn 

The logical resource number associated with the station. 

The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 

level 

The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 

The level for all polled VIP's on a common MLCP channel 
must be the same. 

X'channel 

You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 
X'040n' to X'FF8n'), that specifies the channel number 
of the station and the interrupt priority level (n) of 
the line. The channel number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the 

send or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

2 - Bell 2xx-type modem (201A, 208B, etc.). The data- 

set-ready signal is needed for a connection; absence - 
of this signal is a disconnection. \ y 
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3 or greater - User-defined modem type (see "MODEM Direc¬ 
tive," earlier in this section). 

The default value is modem type 2. 

[ poll_address] 

Specifies the address of the VIP station on the line 
specified by the channel argument. The value for poll_ 
address is an integer from 0 through 31. If no polling 
address is specified, no polling can occur on the line; 
in this case, only one VIP station can be on the line. 

[{ 5 }] 

This argument is meaningful in only two situations: 

(1) a file-transmission (nonpolled) environment and 

(2) a nonpolled environment wherein the VIP is to be 
accessible through the file system interface. (In the 
second situation, the VIP directive must be "paired" with 
an appropriate DEVICE directive.) 

C specifies that the central processor is the control 
station; T specifies that the central processor is the 
tributary station. The tributary station must send the 
first Q (quiescent) frame on the line. The default value 
is C. 


(In the nonpolled, file system access environment, 

T should be specified in the VIP directive in order to 
avoid excessive delays in input/output operations.) 

[ROP lrn] 


Specifies the logical resource number of a receive-only 
printer connected to the VIP controller. The value for 
ROP_lrn is an integer from 3 through 252. The default 
is that no receive-only printer is connected to the VIP 
controller; in this case, the ROP_type and ROP_form feed 
arguments must not be specified. 

[ROP_type] 

Specifies the type of receive-only printer. Choose from 
one of the following: 


ROP_type 


Corresponding 
device type 


TN 300 (default) 

TN1200 

TTY 3 3 

TTY 3 5 


TermiNet 300 or PRU1003 
TermiNet 1200 or PRU1005 
ASR-33 
ASR-35 
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Q. [ROP_form_feed] 

** > Specifies whether the receive-only printer has a 

form-feed option. FORM or FO indicates that the 
receive_only_ printer does have the form-feed option; 
NOFORM or NO indicates that it does not have the 
form-feed option. 

The default is that TermiNets have the form-feed option 
and the TTY's do not have the form-feed option. 

NOTE: The following rules apply to lines that have more than 

one VIP station (i.e., a polled VIP environment): 

(1) a separate VIP directive is required for each 
station on the line, (2) the VIP directives be con¬ 
secutive, and (3) the logical resource numbers of the 
stations on the line must be consecutive. 

Examples: 

In the following examples, VIP stations are connected by Bell 
2xx-type modems. Default values for modem type have been 
used. DEVICE directives are "paired" with the VIP directives 
because the VIP's are to be accessible through the file 
system interface. 

Example 1: 

VIP 23,8,X'FE80',,0 
DEVICE VIP00,23,8,X'FE80•,VIP0 
In this example, the VIP has a poll_address of 0. 

Example 2: 

VIP 24,8,X'FE80',,1,,25,TN1200 

DEVICE VIP01,24,8,X'FE80',VIP1 

DEVICE ROPOl,25,8,X'FE80',ROP1 

In this example, the VIP has a poll_address 'of 1. In addi¬ 
tion to the VIP screen, the VIP controller has a TermiNet 
1200 as a receive-only printer. The VIP screen's logical 
resource number is 24 and the receive-only printer's logical 
resource number is 25. 
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VROSY, VTTY, AND V7200 DIRECTIVES 1 ' 2 

Directive Name: VROSY, VTTY, or V7200 

These directives define devices that are on lines serviced 
by the ATD line protocol handler. Except for the directive 
name, the format is the same for all three directives. You 
can float channel assignments in these directives. 

Format: 

( VROSY | 

< VTTY ;lrn, level,X'channel',[modem],[speed],[device_typel, 
*V7200 ) [del] ,[stop_bit] [,parity] 

Argument Description: 

lrn 

The logical resource number associated with the station. 
The value for lrn is an integer from 3 through 255. A 
program may use this number to identify the station when 
it requests an input/output operation to the station. 


1 The ATD directive Intended as a replacement for the VROSY, VTTY, * 
and V7200 directives. The line protocol handler called by the 

ATD directive offers additional support capabilities (e.g., 
block mode support of VIP7801/7802 devices, support of the I 

VIP7207 device) not offered by the line protocol handler called I 
by the VROSY, VTTY, and V7200 directives. The VROSY, VTTY, and I 
V7200 directives can still be used. The directives, however, I 
call the ATD line protocol handler. 

2 The ATD directive or the V7200 directive must be specified if g 

VIP7200/7205 or VIP7801/7802 terminals are to be used for forms | 
processing using Honeywell's Display Formatting and Control I 

Facility. The VIP 7200 line protocol handler "nonforms mode" is I 
not supported by ATD. The equivalent functions can be obtained I 
by using the forms mode with a form defined as fully I 

unprotected. 
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level 


The priority level at which the communications supervisor 
processes requests for an input/output operation to the 
station. The value for level is an integer from 7 
through 61; it may be the same as the level specified for 
other communications stations, but it must be a higher 
number than the communications interrupt level(s) speci¬ 
fied in the COMM directive. The level specified for one 
or more communications stations may not also be used for 
noncommunications devices or tasks. 

X'channel' 

You may specify a single zero (0) to float this channel 
assignment or a four-digit hexadecimal number (from 
X'040n' to X'FF8n'), that specifies the channel number 
of the station and the interrupt priority level (n) of 
the line. The channel number has the following format: 

Bits 0 through 9 - The 10-bit channel address of the send 

or receive channel on the line. 

Bits 10 through 13 - Must be set to zero. 

Bits 14 and 15 - Specifies n, the priority level at which 

a communications line interrupts the 
central processor. n may have a value 
of 0,1,2, or 3 as specified in the COMM 
directive. See the description of the 
COMM directive for further information. 

[modem] 

A number specifying the type of data set. Possible 
values are as follows: 

0 - Direct connect. 

1 - Bell lxx-type modem (103A, etc.). Both data-set- 

ready and carrier-detect signals are required for a 
connection; absence of these signals is a 
disconnection. 

* 3 or greater - User-defined modem type (see "MODEM Direc¬ 

tive," earlier in this section). 

The default value is modem type 1. 
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[speed] 


The data rate in bits per second. 

For an asynchronous line with a communications-pac whose 
id is 2108 16 , use one of the following values for speed: 

50 300 2400 

75 600 3600 

(default) 110 900 4800 

134 1200 7200 

150 1800 9600 

For an asynchronous line with a communications-pac whose 
id is 2100 16 , 2110 16 , or 2118 16 , use one of the following 
values for speed: 

50 200 1800 

75 300 2000 

(default) 110 600 2400 

134 1050 4800 

150 1200 9600 

In VTTY or V7200 directives, you have the option to defer 
selection of the line speed until the terminal comes on¬ 
line. You select this option by specifying HI or LO. 

'HI' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 1200 through 9600 bits per second. 

' LO' 

Specifies that all terminals associated with this 
line will be permitted to function only at speeds 
from 110 through 1200 bits per second. 

For more information about the line speed selection capa¬ 
bility, refer to the discussion under "Topics Related to 
CLM Directives" near the beginning of this section. 

[device_type] 

Specifies the type of terminal used. The allowable types 
and the default for each directive are as follows: 
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Directive 


Devices supported 


device type 


V7200 VIP 7200, VIP 7205 7200 

VIP 7801, VIP 7802 7801 

VROSY PRU 1001, PRU 1003, PRU 1005, PRU 

TWU 1001, TWU 1003, TWU 1005 

VTTY An asynchronous terminal that TTY 

is to be supported as 
teleprinter-compatible 


[del] 

In the TTY mode, a head-of-form sequence (pre-order con¬ 
trol) consisting of three LF's and the number of DEL 
characters specified by this argument is generated if the 
following conditions are met. (If the conditions are not 
met, no head-of-form sequence is generated.) 

• The first byte of the application's buffer must be 
designated as a control byte; i.e., bit 4 of the 
IORB's device specific word (I_DVS) must be set 

to 0 at write time. 

• The control byte must specify that a head-of-form 
sequence is to be generated; i.e., bit 3 of the 
control byte must be set to 1. 

• Device type PRU is not specified. If it is speci¬ 
fied, a true head-of-form is issued. 

In the field or TTY modes, an LF in an end-of-message 
sequence (post order control) is followed by the number 
of DEL characters specified by this control argument. 

The EOM sequence is controlled by the B- and C-bits of 
the IORB's device specific word I_DVS, as specified by 
the application at write time. The TTY line protocol 
handler sends an EOM sequence according to the following 
B- and C-bit values. 

I DVS Bits 


B 


0 0 CR 

0 1 None 

1 0 CR,LF,DEL characters 

1 1 LF,DEL characters 
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At read time, the application can specify the same B- and 
C- bit values in order to send an EOM sequence back to 
the terminal when the message is successfully received. 

Note that an LF character in a pre-order control speci¬ 
fied by the I_CON word of an IORB is never followed by a 
DEL character; i.e., this control argument has no effect 
in this case. 

This argument allows you to select 1 to 32 DEL char¬ 
acters. The default for each type of device is as 
follows : 

device type Number of DEL Characters 

7200 0 

7801 0 

PRU 1 

TTY 1 


[stop_bi t] 

Specifies the number of stop bits that are to follow each 
character. A value of 1 or 2 can be chosen for each 
device. Default values are as follows: 

Number of Stop Bits 

1 

(For speeds greater 
than 110 bits per 
second) 

2 

(For a speed of 110 
bits per second or 
less) 

[parity] 

Specifies the type of parity (enter ODD or EVEN) to be 
used. The default is EVEN. 
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SECTION 7 


MOD 400 PROGRAM MATERIALS AND DISTRIBUTION MEDIA 


A listing of MOD 400 program materials is provided in 
Figures 7-1 through 7-19. Figure 7-1 lists the program materials 
made available with the MOD 400 Executive. Figures 7-2 through 
7-19 list the program materials made available with the various 
separately-priced products that can be used with the MOD 400 
Executive. Order numbers for these products are also provided. 

MOD 400 software is available on the following media: 

• Cartridge Disk 

• Cartridge Module Disk 

• Mass Storage Unit 

• Diskettes 

MOD 400 Executive software can be distributed on two 
cartridge disks (''ZSYSSl and ~ZSYS52), a single cartridge module 
disk (~ZSYS61), or on a single mass storage unit ( , 'ZSYS71). If 
an installation orders any of the separately-priced products, 
appropriate modules are added to ''ZSYSSl and ~ZSYS52, ''ZSYS61, or 
"ZSYS71, or they are provided on separate diskettes. 

MOD 400 Executive software is made available on up to five 
diskettes pZSYSOO, ~ZSYS0A, “ZSYS01, "ZSYS1A, ~ZSYS1B). The 
software will be packaged to make most effective use of the 
distribution media. Software will be packaged in up to five 
diskettes if the user receives the software on single-sided 
diskettes. If the user submits diskettes with a larger capacity, 
then fewer diskettes are required. 

Users performing system installation with Honeywell-supplied 
distribution media should note the following: 

• If the MOD 400 Executive was distributed on cartridge 
disks, a cartridge module disk, or a mass storage unit, 
then all Executive modules will be present on the 

volume(s) . 
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• If the MOD 400 Executive was distributed on multiple 

diskettes, then each diskette will contain a subset of the 
total number of Executive modules. The diskette labeled 
/ 'ZSYS00 must be used as the bootstrap volume at initial 
system startup. The user must be aware, however, that 
~ZSYS00 will not contain sufficient software to permit use 
of the full range of MOD 400 functionality. Once the user 
attains the limited processing environment permitted with 
~ZSYS00, then the user should examine the contents of the 
other diskettes and delete and transfer software modules 
as desired. The user can consult Figure 7-1 to identify 
Executive modules required for various MOD 400 functions. 

In Figures 7-1 through 7-19, elements enclosed within boxes 
are file system directories. Other elements are files. 1 
Indentation signifies subordination - that is, all files 
described in a given directory are indented from the margin of 
the boxed directory name. In a few instances, one directory is 
shown to be subordinate to another directory; again, indentation 
is used to signify this relationship. 

SOFTWARE TO BE PLACED ON THE BOOTSTRAP VOLUME 

Certain modules must be present on the bootstrap volume in 
order to achieve system startup. Other modules must be present 
on the bootstrap volume if certain types of processing are to be 
supported. These required modules are described in the following 
diagrams. 


at in some cases files are immediately subordinate to the 
root directory. 


i Note t 
volume 
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Z3EXECUTIVES a 
Z3EXECUTIVEL b 
START_UP.EC 
GROUP$H.EC 
GROUP$P.EC 
SUPER.EC 

GROUP$D.EC 

DEBUG.WORK 

DEBUGDB 

RECOVERY 

FILES 

GROUPS 



START_UP.EC 

EML 

EMLFILE 

MDD 

$PR.Q2 

$PR.Q3 

UDD 

REPORTS 



ZIMLCC.O 

ZGQISB.O 


SAF system executive; required 

LAF system executive; required 

File used with CLM_USER; required 

EC file to spawn $H task group 

EC file to spawn $P task group 

EC file required for a dual-purpose operator 
terminal 

EC file to spawn $D task group 
Work file for $D DEBUG 
Lead task of $D DEBUG utility 
File recovery 

File used for $H task group; required if 
CLM_MDC or CLM_MCP used 

Error message library 

mailbox queue 
mailbox queue 


Figure 7-1. MOD 400 Executive Program Materials 
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MACRO 

INCLUDE 

CCP_MAC.IN.A 
MGIRB.IN.C 
MGRRB.IN.C 
DLCP. IN.A 
MGCRB.IN.C 

SID 

START_UP.EC File used with CLM_MDC or CLM_MCP; required 

~ only if either is present 

CLM_SAMPLE Sample CLM file; optional 

CIPSIM Commercial simulator 

CLM Configuration Load Manager; required 


CLMCM1 

CLM 

functions; 

required 

CLMCM2 

CLM 

functions; 

required 

CLMCM3 

CLM 

functions; 

required 

CLMCM4 

CLM 

functions; 

required 

CLMCOM 

CLM 

functions; 

required 

CLMDEV 

CLM 

f unctions; 

required 

CLMFLT 

CLM 

functions; 

required 

CLMMMU 

CLM 

functions; 

required 

CLMLHD 

CLM 

functions; 

required 

CLMMAP 

CLM 

f unctions; 

required 

CLMST1 

CLM 

tables; required 

CLMST2 

CLM 

tables; required 

CLMST3 

CLM 

tables; required 

CLMVAR 

CLM 

functions; 

required 


RESOLA Makes all Executive overlays resident; 

optional 0 


Figure 7-1 (cont). MOD 400 Executive Program Materials 
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ID | (cont) . 
ROLLCD 

SIPSIM 

SIPSIM_SP 

VLDCD 

ZERRST 

ZGQCDS 

ZNV72F 

ZNVDAM 

ZQEACU 

ZQESEL 

ZQEXEC 


CLM code for rollout function; required only 
if rollout capability is configured 

Single/Double Precision SIP Simulator 0 

Single Precision SIP Simulator 0 

CLM code for MMU functions; required only if 
MMU present 

Error statistics module; optional 0 

CLM communications module 0 

Display Formatting and Control software 0 

Display Formatting and Control software 0 

Auto Call module; optional 0 

Speed select module; optional 0 

Communications supervisor 0 


ZQHLPH 


Communications HASP line protocol handler; 
optional 0 


ZQPATD 


Communications asynchronous terminal line 
protocol handler; optional 0 


ZQPCRT 


Communications synchronous terminal line 
protocol handler; optional 0 


ZXPFR 


ZQPTTY 

ZQPVIP 


ZQRCI 


Power Resumption Facility; optional 0 

Communications TTY line protocol handler 0 

Communications VIP line protocol handler 0 

Communications RCI line protocol handler; 

optional 0 


ZQTDUM 


ZQTRAX 


ZXDEFM 


ZQECP1 


Required for a communications configuration 0 
Internal Diagnostic Trace Capability 0 
Defective Memory Trap Handler 0 
Auto Call channel control program; optional 0 


Figure 7-1 (cont). MOD 400 Executive Program Materials 
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SID (cont). 



ZQPATC 

ATD channel 

control program; optional 0 

ZQPCCP 

STD channel 

control program; optional 0 

ZQPTCP 

TTY channel 

control program; optional 0 

CLM MCP 

File of CLM 

directives used during stage 1 


system startup with MLCP/DLCP-connected 


operator terminal; required if your installa- 


tion has an 

MLCP/DLCP-connected operator 


terminal. 


CLM MDC 

File of CLM 

directives used during stage 1 


system startup with MDC-connected operator 


terminal; required if your installation has 


an MDC-connected operator terminal. 

SYSLIB1 



EC 

Execution command used for EC files; required 


if any START 

' UP.EC file used 

CSD 

Change system directory operator command; 


required 


SYSLIB2 

SYSLIB2 (cont). SYSLIB2 (cont). 

ABORT BATCH 

DP 

PR HOLD 

ABORT GROUP 

DPEDIT 

QUERY 

ABR 

DPN 

RDF 

ACTB 

DT 

RDN d 

ACTG 

EBR 

RESTART 

AGR 

EC d 

SD 

AMM 

EGR 

SET ELOG 

AMT 

EQUAL 

SET LISTEN 

BYE 

ETR 

SG d 

CB 

FO 

SMM 

CG 

LISTENER 

SSPB 

CGRQ 

LOAD 

SSPG 

CMBX 

LQR 

ST 

CQR 

LSR 

START ELOG 

CT 

MAIL 

START MAIL 

CVD 

MSG 

S TG 

DB 

MSW d 

STOP ELOG 

DEBUG 

NEW PROC 

STS 

DEL CUM 

NOW 

TIME 

DG 

OPER 

UNLD s 

DMNC 

PR ELOG 

UPD CUM 

DM ON 

PR CUM 

USER 





Figure 7-1 (cont). MOD 400 Executive Program Materials 
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SYSLIB2 (cont) . SYS LIB 2 (cont). SYSLIB2 (cont) . 


VFORMS 

DBP 

LTC 

ZELUPD 

DC A 

LWD d 

ZNVCRM 

DD 

LX 

ZNVUPR 

DISSOC 

M4 SYSDEF 

ZXLOG 

DL 

MFK 

ASSOC 

DX 

PATCH 

BC 

ED d 

PR 

BPI 

EX PAM 

PR QK 

BPS 

FC 

QRPT 

CBP 

FCDE 

RECOVER 

CD 

FD 

REMOVE 

CF 

FDDE 

RESTORE 

CKMSV 

GET 

RL 

CKPTFILE 

GQ 

RN 

CMR 

IM PAM 

RQM 

CP 

ISLCON 

SA 

CPA 

IT 

SAVE 

CPAS 

PX 

SCA 

CPADE 

RX 

SDL 

CPDE 

LA 

STTY 

CR 

LCA 

TPOS 

CSD d 

LCD 

UNSP 

CV 

LHD 

VALIDCKPT 

CVDE 

LINKER 

WH 

CWD d 

LMR 

WS 

CX 

LS 

DMBX 

DA 

LSDE 



d 


FORMS 


TV 


TV 

(cont) . 

PROGS 


VDAM_FORM01 

RDYT 


CDUG1 

DIMG1 

PRMG1 

TCSGI 


MT9G1 

MT7G1 

ZTVM 

ZTVIOD 


TRANS 


a Present only on SAF medium 
b Present only on LAF medium 

c If the system is to include this capability, this system software 
must be present on the bootstrap volume before configuration. 

NOTE: Software modules listed as being optional may be judi¬ 

ciously deleted if the user does not wish to configure a 
particular capability; otherwise, the appropriate software 
modules must be included with the Executive software if 
the user wishes to configure an optional capability. 

d Required for Stage 1 and Stage 2 system startup. 


Figure 7-1 (cont). MOD 400 Executive Program Materials 
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Figure 7-2. Assembler/Macro Preprocessor 
Program Materials (SHL928) 



Figure 7-3. FORTRAN Program Materials (SHL921) 



Figure 7-4. Entry-Level COBOL Program Materials (SHL917) 
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SYSLIB2 


RPG 

AUTO 

AUTOR 


Figure 7-5. RPG Program Materials (SHL926) 



SYSLIB2 


SORT 

SORTC 

MERGE 


Figure 7-6. SORT/MERGE Program Materials (SHF909) 


[ SID | 

ZQPBSC 1 

HLPH 1 


SYSLIB2 


TRANB 


These program materials must be transferred to the bootstrap 
volume before configuration. 


Figure 7-7. File Transmission (Non-Honeywell Host) 
(SHC909) 


SYSLIB2 


COBOLI 


ZCIRT 


COBOLI (intermediate level 


object modules 


Figure 7-8. Intermediate COBOL Program Materials 
(SHL925) 
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ZDRT 

DEF_SAMPLE.S 
object modules 


Figure 7-9. DEF-I Program Materials (SHC917) 


SYSLIB2 


RBT 



Figure 7-10. RBF/66 Program Materials (SHC915) 


SID 

SYSLIB2 

Z QPPVE 1 

TRAN 

ZQHLOG 1 


ZQHPLM 1 


RBRCIP 1 




iThese program materials must be transferred to the bootstrap 
volume before configuration. 


Figure 7-11 


File Transmission (Honeywell Host) 
Program Materials (SHC911) 



Figure 7-12. HASP Workstation Facility Program 
Materials (SHC926) 


SYSLIB2 


WS 278 0 
WS3780 


Figure 7-13, 


2780/3780 Workstation Facility 
Program Materials (SHC922) 


7-10 


CB23-03 

















IF3271 

ZF32IN 


ZCOBIF.O 

’These program materials must be transferred to the bootstrap 
volume before configuration. 


Figure 7-14. Programmable Facility/3271 Program 
Materials (SHC924) 



Figure 7-15. TCLF Program Materials (SHS920) 


SYSLIB2 

FORTRANA 

ZF1RT 

runtime routines 

Figure 7-16. Advanced FORTRAN Program Materials (SHL927) 


( 
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BASIC 

RESEQ 

LNKBPRG. EC 


runtime routines 


ZBRTS 


runtime routines 


Figure 7-17. BASIC Program Materials (SHL930) Interpreter 
(SHL931) Interpreter/Compiler 


SYSLIB2 

DEF 

DEFFIG 

DEFSTA 

DEFMENU 

DEF-II system forms 


Figure 7-18. DEF-II Program Materials (SHC949) 



Figure 7-19. Advanced COBOL Program Materials (SHL933) 
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SECTION 8 


TECHNICAL NOTES 


This section describes a number of miscellaneous 
of which pertain only to certain installation sites, 
attempting any use of the system, you should ascerta 
these topics apply to your installation and proceed 
The following topics are described: 


topics, most 
Be fore 
in which of 
accordingly. 


• CSD (change system directory) operator commands in 
START_UP.EC file for system task group 

• Transferring the contents of ''ZSYS51 or ~ZSYS61 to the 
fixed platter of a two-platter drive 

• System search rules and the system commands 

• Procedure for transferring software modules 

CSD OPERATOR COMMANDS IN START_UP.EC FILE FOR SYSTEM TASK GROUP 


* 


* 


If a START_UP.EC file is used for the system task group 
during a stage 3 system startup 1 , it must be immediately subordi¬ 
nate to the root directory of the bootstrap volume. This 
START_UP.EC file should contain one or more CSD (change system 
directory) operator commands to reassign the system libraries 
-LIB1 and -LIB2 away from their defaults (the default assignment 
for both -LIB1 and -LIB2 is SYSLIB1 on the bootstrap volume). 

If the system is to be bootstrapped from a non-diskette 
volume, the START_UP.EC file for the system task group should 
contain the following two CSD operator commands (in addition to 
any other appropriate operator commands) : 

CSD -LIB1 pathname_to_user_library 

CSD -LIB2 >SYSLIB2 


iThe stages of system startup are described in Section 3. 
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These operator commands will appropriately specialize the sys¬ 
tem's search rules for this environment. When the system's 
loader seeks a bound unit to be loaded, it will first search the 
user's working directory (default), then (if necessary) the user_ 
library (-LIB1), then (if necessary) SYSLIB2 on the bootstrap 
volume (-LIB2). 

If the system is to be bootstrapped from diskette (~ZSYS00), 
the START_UP.EC file for the system task group should contain the 
following CSD operator command: 

CSD -LIB1 ~ZSYS01>SYSLIB1 

This operator command will appropriately specialize the system's 
search rules for a diskette environment. When the system's 
loader seeks a bound unit to be loaded, it will first search the 
user's working directory (default), then (if necessary) 
' V ZSYS01>SYSLIB1 (-LIB1). Typically, in a diskette environment, 
the operator uses dynamic CSD operator commands to assign -LIB2 
to the pathname that will be searched (if necessary) following 
< 'ZSYS01>SYSLIB1. 

TRANSFERRING CONTENTS OF ~ZSYS51 OR ~ZSYS61 TO FIXED PLATTER 

t 

If your system is cartridge-disk-based or cartridge-module- 
disk-based, you may wish to copy the contents of your system 
volume to the fixed platter of a two-platter drive. The original 
Honeywell-supplied system volume may then be dismounted and saved 
as backup. The following procedure is recommended 1 : 

1. Mount system volume ~ZSYS51 on RCDOO, or mount system 
volume ~ZSYS61 on RCMOO. 

2. Perform a stage 2 system startup, bootstrapping the 
system from RCDOO or RCMOO. 


i Assume that this action involves a stage 2 system startup; the 
CLM_USER file is assumed to include the following DEVICE 
directives : 

For cartridge disk-based systems: 

DEVICE RCD00,1,6,X'1400' (removable cartridge disk) 

DEVICE FCD00,3,6,X'1400' (fixed cartridge disk) 

For cartridge module disk-based systems: 

DEVICE RCMOO,1,6,X'1400' (removable cartridge module disk) 
DEVICE FCM00,3,6,X'1400' (fixed cartridge module disk) 
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3. Use the following CV (create volume) command to initial¬ 
ize the fixed platter of the cartridge disk: 

CV !FCDOO -FT ZUSR51 

(ZUSR51 is merely an example of a user-supplied volume_ 
id.) 

If your system is cartridge module disk-based, use the 
following CV (create volume) command to initialize the 
fixed platter of the cartridge module disk: 

CV !FCMOO -FT ZUSR61 

(ZUSR61 is merely an example of a user-supplied volume 
id.) 

4. Use the following CP (copy) command to copy the entire 
contents (except volume_id) of ~ZSYS51 to "ZUSR51: 

CP !RCD00>Z SYS 51 (FCDOO -VOL 

If your system is cartridge module disk-based, use the 
following copy (CP) command to copy the entire contents 
(except volume_id) of "ZSYS61 to "ZUSR61: 

CP !RCM00>ZSYS61 (FCMOO -VOL 

5. After the copy is completed, press STOP. 

6. Perform another stage 2 system startup, this time boot¬ 
strapping the system from FCDOO or FCMOO, as appropriate. 
(Enter 1401 into the Rl-register after the TRAFFIC light 
turns off following Stop, CLeaR, Load, Execute.) 

7. When system startup is complete, dismount ~ZSYS51 from 
RCD00 or ~ZSYS61 from RCM00. 

8. Mount a new cartridge disk on RCD00 or RCM00, as 
appropriate. 

9. For cartridge disk-based systems, use the following CV 
command to initialize the new cartridge disk: 

CV (RCD00 -FT USRVOL 

For cartridge module disk-based systems, use the follow¬ 
ing CV command to initialize the new cartridge module 
disk 

CV !RCM00 -FT USRVOL 

(USRVOL is merely an example of a user-supplied volume_ 
id.) 
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10. Use the following CV command to create a bootstrap record 
on “'USRVOL: (The bootstrap record must be on the 

removable volume, even though the system is to be boot¬ 
strapped from the fixed platter.) 

CV !RCDOO>USRVOL -BOOT [X * 1401'] 1 

For cartridge module disk-based system, use the following 
command: 

CV ! RCM00 >USRV0L -BOOT [X'1401'] 1 

NOTE: After a bootstrap record on a removable cartridge 

disk or cartridge module disk has been used to 
bootstrap the system executive from the fixed 
cartridge disk or cartridge module disk, the 
volume_id of the fixed cartridge disk or cartridge 
module disk is assumed to be to the left of an 
absolute pathname that begins with a greater-than 
sign (>) . 

SYSTEM SEARCH RULES AND THE SYSTEM COMMANDS 

The system builder should insure that system commands (or at 
least that subset of system commands most frequently used) are 
accessible to the system's loader. 

When the system's loader seeks a bound unit to be loaded, it 
proceeds as follows: 

If the user supplies a full pathname (one beginning with a 
circumflex and the volume id), then the system loader will 
search for that specific element. 

If the user supplies a simple (single-element) pathname, then 
the system loader will search for the element according to a 
set of search rules. 

The search rules specify the order in which the loader is to 
search one or more directories for the element in the simple 
pathname. The default search rules for MOD 400 are (1) first 
search the user's working directory, (2) next search the system 
directory SYSLIB1 on the root volume and (3) finally search the 
system directory SYSLIB2 on the root volume. 


ilf X 1 14b1 1 is not specified, 1401 must be entered into the Rl- 
register (as shown in step 6) whenever the system is boot¬ 
strapped from the fixed platter; however, other bootstrap 
options (see Table 3-2) can be used more flexibly if the boot¬ 
strap channel number (plus options) is entered into the Rl- 
register each time the system is bootstrapped. 
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The operator can use the CSD command to change the system 
search rules. In normal operations the operator should use the 
CSD command to specify that one of the directories to be searched 
is the system directory containing the system commands. The user 
should note that those system commands not accessible to the 
loader under the search rules must be specified with a full path¬ 
name. (For example, the CP command would require the user to 
specify < 'volume_id>SYSLIBl>CP.) 

PROCEDURE FOR TRANSFERRING SOFTWARE 

A procedure for transferring modules is described below. 

Prior to performing the procedure, the user should, of 
course, determine the modules to be transferred and the unneeded 
elements on the volume to which new software is to be added. 
Section 7 contains a description of the contents of all disks. 

1. Mount the volume containing the modules to be transferred 
on an available drive. 

2. Use a list names command (LS) to ascertain the size of 
the modules to be transferred. 

3. Mount the volume to which the modules are to be 
transferred. 

4. Use an LS command to ascertain the size of unneeded 
elements. 

5. Release unneeded elements. 

6. Mount a new diskette on an available drive. Use a create 
volume command (CV) to initialize this diskette. (Use a 
temporary, unique volume identifier.) 

7. Use a create directory command (CD) to create appropriate 
directories on the new diskette. 

8. Use a copy command (CP) to copy the remaining contents of 
the volume mentioned in step 3 to the new volume. 

9. Ensure that the volume referenced in step 1 above is 
mounted and use a copy command to copy the appropriate 
modules to the new volume. 1 


iWhen adding elements to the bootstrap volume, the system builder 
should remember that if a rollout capability is to be estab¬ 
lished, sufficient space must be available on the volume for the 
ROLLOUT file created during system configuration; this rollout 
file must be large enough to accommodate the batch memory pool. 
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10. Use a CV command to rename the new volume. (If the new 
name duplicates the name of a currently-mounted volume, 
the system will issue a dismount message, directing you 
to dismount the newly-renamed volume.) 


/#' 


8-6 


CB23-03 



APPENDIX A 


STARTUP HALTS 

Startup halts may be classified in three categories: 

• Halts related to bootstrap operation. 

• Error halts related to Configuration Load Manager. 

• Error halts related to other aspects,of system 
initialization. 

A halt related to the bootstrap operation may have been 
intentionally requested, or it may reflect an error condition. A 
bootstrap halt is intentionally requested by setting ON bit 13 of 
the 16-bit (four hexadecimal digits) bootstrap channel number 
(see Table 3-2). In the event of this type of bootstrap halt, 
the following register contents are significant: 

• Rl-register contains bootstrap channel number. 

• R2-register contains address mode flag: 0 indicates SAF; 

1 indicates LAF. 

• R3-register identifies the bootstrap device type: 

0 indicates cartridge uior., v.c.rtridg-' module disk, or mass 
storage unit; 1 indicates diskette. 

Error halts during bootstrap result in a 16nn value in the Rl- 
register. See the System Messages manual for a description of 
the 1611, 1612, and 1616 error halts. 

NOTE: If a bootstrap halt occurs with a 16*16 error condi¬ 

tion, there is a possibility that the D7 register will 
contain no error status. To obtain status in such 
circumstances, select D7 prior to retrying the opera¬ 
tion and observe D7 during bootstrap processing. 
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Error halts related to the Configuration Load Manager result 
in a 13nn value in the Rl-register; usually additional informa¬ 
tion relative to the halt is available in, or through, other reg¬ 
isters. See the System Messages manual. Note that if an opera¬ 
tor terminal is connected to an MDC (and if its DEVICE directive 
has already been read), a Configuration Load Manager error condi¬ 
tion produces an error message at the operator terminal; in this 
case, a halt occurs (in addition to the message) only under cer¬ 
tain error conditions. Configuration Load Manager error messages 
are described in the System Messages manual. 


Error halts related to other aspects of system initializa¬ 
tion result in a 99nn value in the Rl-register; in some cases, 
additional information relative to the halt is available in, or 
through, other registers. See the System Messages manual. 
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APPENDIX B 


SYSTEM OVERLAYS 


Table B-l provides a list of all system overlays that can be 
made permanently resident in the system area of memory. Each 
overlay to be made permanently resident must be named in a RESOLA 
directive (described in Section 5). Multiple system overlays can 
be named in a single RESOLA directive. 

Beside each overlay name in Table B-l is the approximate size 
(in decimal words) the overlay requires in memory if it is made 
permanently resident. In certain cases, footnotes indicate 
groups of overlays that should all be made permanently resident 
if optimum speed is desired for the related function. Elsewhere, 
in cases where a function is divided into phases, both phases of 
the function should be made permanently resident if optimum speed 
is desired for that function. 


Table B-l. System Overlays 


Overlay 

Name 

Size 

(in Words) 

Function 

Executive 

Services 



OIOIMS 

415 

OIM dispatcher (all LRN 0 orders) 

OIMIMO 

321 

OIM input processor 

0I0IM1 

401 

OIM command processor, output completion, 
and break handler 

0I0IM2 

331 

OIM output control 

0I0IM3 

417 

OIM diagnostics 

0I0IM4 

451 

OIM abort group request purge and OIM 
monitor call handler 

OMSTAT 

277 

$STMP (status memory pool) macro handler, 
and get specific memory block 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Size 

(in Words) 

Function 

OOBIND 

226 

Loader - Processing of relocation items 

OOCROT 

169 

Loader - Create OAT and release, wait and 
recall overlay MCL handler 

OOMSCO 

234 

Loader - Processing of SLIC load units, 
unloading of bound units 

OOPACK 

255 

Loader - Resolution of symbols defined by 
LDBU's and of root entry names 

OOROOl 

243 

Loader - Load of bound unit (phase 1) 

00R002 

296 

Loader - Load of bound unit (phase 2) 

OUEML2 

241 

Error message library processing 

OUERS1 

302 

Error reporter (phase 1) 

OUERS2 

357 

Error reporter (phase 2) 

OUERS3 

319 

Error reporter: trap errors only 

OXACSP 

149 

Break task activation/suspension 

OXAVR1 

50 

Automatic volume recognition 

OXBXFR 

114 

Bound-unit transfer MCLs 

OXC_IX 

397 

Convert from/to external/internal date/ 
time 

OXCTSK 

491 

Create and spawn task 

OXCDRV 

245 

Create driver (initialization use only) 

OXCGRP 

499 

Create and spawn group 

OXCKPT 

n o *3 

Checkpoint, determination of checkpoint- 
ability and phase 1 of checkpoint 

OXCKP1 

226 

Checkpoint - phase 2 

OXCKP2 

498 

Checkpoint - phase 3 

OXCKPA 

479 

Checkpoint file assignment - part 1 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Si ze 

(in Words) 

Function 

OXCKPA2 

474 

Checkpoint file assignment - part 2, and 
checkpoint file disassignment 

OXDFRT 

511 

Place deferred spawn task request 



Spawn deferred task (after defer interval) 

OXDLGP 

448 

Delete/abort group (and abort group 
request) 

OXDTSK 

488 

Task Deletion (created or spawned tasks) 



Request task deletion (created tasks) 

OXELOG 

471 

Error logging MCLs 

OXESWO 

84 

External switch handler 

OXGACT 

323 

Group activate (rollout phase 2) 

OXGSSP 

274 

Group suspend (rollout phase 1) 

OXGRQS 

312 

Start group request (phase 1) 

OXGRS2 

422 

Group request startup (phase 2) 

OXGRQT 

461 

Terminate group request (phase 1) 

OXGRT2 

263 

Terminate group request (phase 2) 

OXGRT3 

308 

Group request termination (phase three) 

OXMFOl 

337 

Message facility: MCL dispatcher 

OXMF02 

480 

Message facility task request dispatcher: 
Call MF MCLs 

OXMF03 

489 

Message facility activate mailbox; open 
mailbox file (accept and receive - disk 
queuing) 

OXMF04 

393 

Message facility: accept MCLs 

OXMF05 

370 

Message facility: accept,MCLs and read 
record from message facility file (accept 
and receive - disk queuing) 

OXMF06 

398 

Message facility. initiate MCLs 
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Table B-l (cont). System Overlays 



Overlay 

Name 

Size 

(in Words) 

Function 

OXMF07 

257 

Message facility: send MCLs 

OXMF08 

383 

Message facility: send MCLs (disk 
queuing/backup); terminate message MCLs 
(send) 

OXMF09 

377 

Message facility: receive MCLs 

OXMFIO 

479 

Message facility: cancel enclosure level 
MCLs, delete quarantine unit (receive 

MCLs - disk queuing/backup) 

OXMF11 

427 

Message facility: terminate message MCLs 
(receive) 

OXMF12 

340 

Message facility: close mailbox (all 
terminate message MCLs - disks queuing/ 
backup; initiate MCLs - disk queuing; mes¬ 
sage count MCLs) terminate message MCLs 
(waiting acceptor) 

OXPCBU 

139 

Process command line: activate functions 

OXPCL1 

421 

Process command line (phase 1) 

OXPCL2 

434 

Process command line (phase 2) 

OXPCL3 

365 

Process command line: break interrupt 
handler 

OXRQGP 

241 

Request and spawn group (phase 1) 

OXRQG2 

328 

Request and spawn group (phase 2) 

OXRQG3 

261 

Request and spawn group (when mailbox 
queued request) 

OXRST 

504 

Restart phase 1 

OXRSTO 

a n n 

H /LO 

Restart phase 2 

OXRST1 

483 

Restart phase 3 

OXRST 2 

507 

Restart phase 4 

OXRST3 

495 

Restart phase 5 

OXRSTB 

428 

Restart - terminal substitution 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Si ze 

(in Words) 

Function 

OXRSTF 

488 

Restart phase 6 (last) 

OXRSTH 

164 

Restart - bound units preservation 

OXRSTP 

317 

Restart - trap processing and suspension 
activation during restart 

OXRSER 

495 

Restart - error processing 

OXSIOl 

319 

Standard input/output (new user, 
command_in) 

0XSI02 

275 

Standard input/output (new user, user out) 

0XSI03 

186 

Standard input/output (input line 
expansion) 

0XSI04 

119 

Standard input/output (system error_out 
handler) 

OXSMCL 

200 

Process semaphore MCLs 

OXTR17 

204 

Defective memory trap handler 

OXTRPO 

315 

Connect user trap handler (enable, disable 
user traps) 

OXTRR 

139 

Terminal request handler 

OXUPFO 

265 

Identification/information macros 

OXUPF1 

188 

Identification/information macros 

OXWCS1 

62 

Load Writable Control Store 

OXWTLO 

296 

Wait list processing 

File Manac 

jement 


OYASF 

97 

Associate/disassociate file - MCL 

OYCRF 

358 

Create file - MCL 

OYCRR 

295 

Create record descriptors - MCL 

OYDLF 

506 

Delete file - MCL 

OYLKF 

388 

Link file - MCL 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Si ze 

(in Words) 

Function 

OYMDF 

428 

Modify disk file attribute/name - MCL 

OYULF 

247 

Unlink file - MCL 

OZALX 

292 

Allocate disk space - record extent in 
directory 

OZALX2 

459 

Allocate disk space - get space for one 
extent 

OZCRF2 

408 

Create file - primary/alternate index 
parameter 

OZCRF3 

298 

Create file - calc/ids-2 parameter 

OZCRF4 

259 

Create file - permanent file 

OZCRF5 

427 

Create file - temporary file and 
subro utines 

0ZCRR2 

511 

Build record descriptor 

OZLKDR 

248 

Link and rewrite directory record 

OZULDR 

107 

Unlink directory record 

OYGIDV 

83 

Set device information - MCL 

OYGIF 

506 

Get file information - MCL 

OYGTF 

403 

Get file - MCL 

OYRMF 

390 

Remove file - MCL 

OZGTF2 

217 

Get file - save/restore interface 

OZGTF3 

442 

Get file - tape parameter processing 

OZCDDB 

313 

Get file - create device descriptor block 
(DDB) 

OZCFDB 

509 

Get file - create file descriptor block 
(FDB) 

OZGFCB 

504 

Get file - get file control block (FCB) 

OZGTRF 

277 

Get file - get related files 

OYOPNI 

443 

Open file - MCL 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Size 

(in Words) 

Function 

OZOPFD 

278 

Open file - device files 

OZOPFF 

111 

Open file - fixed relative file 

OZOPFU 

357 

Open file - sequential/relative/alternate 

indexes 

OYCLSI 

380 

Close file - MCL 

OZCLFD 

160 

Close file - device files 

OZGRPT 

147 

Group termination 

OYACl 

471 

Set/delete access control (ACL) - MCL 

OZAC12 

486 

Set/delete access control (ACL) - set ACL 

OYAVR 

484 

Automatic volume recognizer (AVR) - MCL 

OYCMR 

437 

Cancel mount request (CMR) - MCL 

OYIT 

352 

Initialize tape (IT) - MCL 

OYSWP 

348 

Swap volume - MCL 

OZAVR2 

507 

AVR - device file other than tape 

OZAVR3 

460 

AVR - initialize disk volume descriptor 
block (VDB) 

OZVMT 

403 

Volume mount - request disk volume mount 

OZVMT2 

403 

Volume mount - request device/tape volume 
mo unt 

OZVMT 3 

406 

Volume mount - search for free tape 

OYCWD 

396 

Change working directory - MCL 

OYXPA 

437 

Expand file pathname - MCL 

OYSTTY 

447 

Set TTY - MCL 

OYWTF1 

241 

Wait file - MCL 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Si ze 

(in Words) 

Function 

Storage Ma 

nagement 


OZSME 

181 

I/O error handler - common to all files 

0ZSME1 

181 

I/O error handler - disk files 

OZSME2 

222 

I/O error handler - message handler 

OZSMT 

111 

Storage management positioning function 
for tape 

OYBPCR 

506 

Buffer pool - create/delete (MCL) 

OYGIBP 

227 

Buffer pool - statistics (MCL) 

OZBF2I 

287 

Buffer pool - flush buffers and disasso¬ 
ciate buffers 

Data Management 


OYDMR2 

167 

Fixed relative - MCL (read/write/rewrite/ 
delete record) 

OYDMR3 

203 

UFAS relative - MCL (read/write/rewrite/ 
delete record) 

OZDMR 

284 

UFAS relative - positioning 

OYDMS1 

255 

String - MCL (read/write/rewrite record) 

OZDMS2 

511 

UFAS sequential - MCL (rewrite/delete 
record) 

OZACCB 

173 

UFAS indexed/random - allocate CCB 
(currency control) 

OZUCCB 

448 

UFAS indexed/random - update CCB (currency 
control) 

OZUSUB 

242 

UFAS indexed/random - common subroutines 

OYDMIl 

510 

Primary indexed - MCL (read/rewrite 
record) 

OYDMI2 

299 

Primary indexed - MCL (write record in 
load mode) 

OYUPI1 

476 

Primary indexed - MCL (insert/delete 
record) 
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Table B-l (cont) . System Overlays 


Overlay 

Name 

Size 

(in Words) 

Function 

OZIEXT 

512 

Primary indexed - initialize for extend 
mode 

OZIOPF 

500 

Primary indexed - open and close 

OZIPSN 

502 

Primary indexed - positioning 

OYDMC 

364 

Calc - MCL (read/write/rewrite/delete 

record) 

OZCER 

76 

Calc - error processing 

OZCINV 

202 

Calc - inventory processing 

OZC KEY 

268 

Calc - hash/compare key 

OZCLNK 

133 

Calc - link/unlink calc record 

OZCOPF 

262 

Calc - open 

OZCPSN 

239 

Calc - locate/position record , 

OZCSUB 

222 

Calc - subroutines 

OZDMC 

72 

Calc - record modification 

OYDMX1 

507 

Alternate index - MCL (read/write/rewrite/ 
delete record) 

OZDMX 

391 

Alternate index - update alternate indexes 

OZXENT 

461 

i 

Alternate index - add/delete index entries 

OZXER 

415 

Alternate index - error processing 

OZXLV1 

325 

j 

Alternate index - create index levels 

OZXPSN 

470 

Alternate index - positioning function 

OZXSP1 

499 

Alternate index - split Cl 

OZXSUB 

366 

Alternate index - subroutines 

OYDMX2 

395 

Alternate index - MCL (read/write/rewrite/ 
delete entry) 

OYDMT 

501 

Tape - MCL (read/write record) 

OZDMT 

! 

487 

Tape - spanned record (read and write) 
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Table B-l (cont). System Overlays 


Overlay 

Name 

Size 

(in Words) 

Function 

OZTCLF 

285 

Tape - close 

OZTEBC 

276 

Tape - EBCDIC and ASCII conversion 

OZTEXD 

469 

Tape - expiration date checking 

OZTOP1 

483 

Tape - open (common) 

OZTOP2 

512 

Tape - labeled tape 

OZTOP3 

316 

/ 

Tape - unlabeled tape 

OZTOP4 

491 

Tape - process tape labels 

OZTPSN 

279 

Tape - positioning 

OZTSUB 

237 

Tape - subroutines, ASCII and binary 
conversion 

OZTUT1 

380 

Tape - subroutines 

Checkpoint 

, Restart, Record Lock, and Recovery Services 

OYCKPT 

293 

Checkpoint - MCL 

OZCKER 

427 

Checkpoint - error reporting 

OZCKPT 

479 

Checkpoint - internal check point 

OYRSRT 

438 

Restart - MCL 

OYUREC 

293 

Unlock record - MCL 

OZBEF 

372 

Before image - data management interface 

OZBISF 

255 

Before image - reservation 

OZBILR 

417 

Before image - initialization 

OZBIOF. 

OQC 

C* J \J 

Before image - offline recovery 

OZBIWR 

275 

Before image - write before image 

OZCLPT 

488 

Clean point - MCL 

OZROLB 

413 

Roll back 
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Table B-l (cont). System Overlays 


a This overlay should 
speed is desired in 

b This overlay should 
speed is desired in 

c This overlay should 
speed is desired in 

dThis overlay should 
speed is desired in 
alternate indices. 

e This overlay should 
speed is desired in 

f This overlay should 
speed is desired in 

9 This overlay should 
speed is desired in 

h This overlay should 
speed is desired in 

'This overlay should 
speed is desired in 

iThis overlay should 
speed is desired in 


be made permanently resident if optimum 
processing UFAS indexed files. 

be made permanently resident if optimum 
processing UFAS relative files. 

be made permanently resident if optimum 
processing UFAS random files. 

be made permanently resident if optimum 
processing indexed and random files, and 


be made permanently resident if optimum 
processing files with alternate indices. 

be made permanently resident if optimum 
processing UFAS tape files. 

be made permanently resident if optimum 
processing EBCDIC tape functions. 

be made permanently resident if optimum 
processing using record locking/recovery. 

be made permanently resident if optimum 
processing file management functions. 

be made permanently resident if optimum 
processing using buffer pool management. 
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APPENDIX C 


EQUIPMENT REQUIREMENTS 


This appendix contains minimum system guidelines and a list 
of supported equipment. 

MINIMUM SYSTEM GUIDELINES 


Minimum system guidelines are offered as aids to system 
builders who must determine the resources required to perform 
meaningful processing at the installation. Minimum system guide¬ 
lines provide base configurations from which the system builder 
can calculate what additional memory and peripheral devices (if 
any) are necessary for efficient and effective operations. These 
guidelines will remain in effect until the next major release of 
MOD 400. 

Minimum System for Program Development 

Program development activity in a single-user environment can 
be accomplished with 64K words of memory (SAF or LAF) and a 
compliment of peripheral devices limited to the following: one 
operator terminal, one printer, and up to four cartridge disks, 
cartridge module disks or mass storage units. 

In such an environment, the user can obtain an online memory 
pool of 38K words (remaining memory would be required to accom¬ 
modate the resident executive and a 6K-word system memory pool). 
Additionally, this minimum system would allow the user to provide 
for the following exhaustible resources: two system overlay 
areas, 17 trap save areas, and 30 intermediate request blocks. 

Minimum System for Online Applications (Execute-Only) SAF Mode 

A configuration with 48K words of memory (SAF mode) and a 
compliment of peripheral devices limited to those described below 
will permit the execution of a wide variety of user applications 
in a single-user environment. 1 


" The 2780/3780 Workstation Facility can be used in an environment 
as described above with 32K words of memory. 
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MLCP 


• Two disks 1 

• One printer 

• One teleprinter-compatible terminal connected to an 
or DLCP 

• A PVE link 

In such an environment, the user can obtain an online memory 
pool of 13K words (remaining memory would be required for the 
resident executive and a 6K word system memory pool). Addition¬ 
ally, this minimum system would allow the user to provide for the 
following: the commercial simulator, two system overlay areas, 

17 trap save areas, and 30 intermediate request blocks. 

Minimum System for Online Applications (Execute-Only) LAF Mode 

A configuration with 64K words of memory and a compliment of 
peripheral devices limited to those described below will permit 
the execution of a wide variety of user applications in a single- 
user environment. 2 

• Two disks 1 

• One printer 

• One VIP7200/05 or VIP7801/02 terminal connected to an MLCP 
or DLCP 

• A PVE link 

In such an environment, the user can obtain an online memory 
pool of 16K words (remaining memory would be required for the 
resident executive and a 6K word system memory pool). Addition¬ 
ally, this minimum system would allow the user to provide for the 
following: two system overlay areas, 17 trap save areas, 30 

intermediate request blocks and the Display Formatting and 
Control Facility software. 


i In an all-diskette system, it is recommended for ease-of-use 
that four diskettes be selected. 

2 The 2780/3780 Workstation Facility can be used in an environment 4 
as described above with 32K words of memory. 
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SUPPORTED HARDWARE 


Table C-l lists Level 6 equipment and options supported by 
MOD 400 when operating on the Model 23 central processor. 

Table C-2 lists the Level 6 equipment and options supported by 
MOD 400 on other central processor models. 1 


Table C-l. Supported Hardware - Model 23 


Category 

Marketing 

Identifier 

Description 

— 

Central 

CPS9351 

23 Minimount, 32K, 

FCP, 

5-slot, 


Processors 


no-disk 





CPS9352 

23 Minimount, 32K, 

FCP, 

9-slot, 




no-disk 





CPS9353 

23 Minimount, 64K, 

FCP, 

5-slot, 




no-disk 





CPS9354 

23 Minimount, 64K, 

FCP, 

9-slot, 




no-disk 





CPS9356 

23 Minimount, 32K, 

BCP, 

5-slot, 




no-disk 





CPS9357 

23 Minimount, 32K, 

BCP, 

9-slot, 




no-disk 





CPS9358 

23 Minimount, 64K, 

BCP, 

5-slot, 




no-disk 





CPS9359 

23 Minimount, 64K, 

BCP, 

9-slot, 




no-disk 





CPS9370 

23 Minimount, 32K, 

FCP, 

7-slot, 

2 6MB 



cartridge module 

disk 




CPS9371 

23 Minimount, 64K, 

FCP, 

7-slot, 

2 6MB 



cartridge module 

disk 




CPS9372 

23 Minimount, 64K, 

FCP, 

7-slot, 

8 0MB 



cartridge module 

disk 




CPS9373 

23 Minimount, 32K, 

BCP, 

7-slot, 

2 6MB 



cartridge module 

disk 




CPS9374 

23 Minimount, 64K, 

BCP, 

7-slot, 

2 6MB 



cartridge module 

disk 




CPS9375 

23 Minimount, 64K, 

BCP, 

7-slot, 

8 0MB 



cartridge module 

disk 




“These tables are not a complete listing of Level 6 equipment. 

In some cases (e.g., cabinetry, cables), equipment is not listed 
because its use is invisible to the software; in other cases, 
equipment is not listed because full software qualification had 
not been performed at the time this document was published. 
Information relative to the operation of GCOS 6 MOD 400 on 
equipment not listed can be obtained from Honeywell Marketing 
Representatives. The user should also note that these tables 
contain no information with respect to installation prerequi¬ 
sites. You cannot use these tables to configure end-user 
systems. 
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Table C-l (cont). Supported Hardware - Model 23 


Category 

Marketing 

Identifier 

Description 

Console 

KCM9301 

Single console adapter 

Adapters 

KCM9302 

Dual console adapter 

Consoles 

DKU9101 

VIP 7100 console, 64-character set 


DKU9102 

VIP 7105 console, 96-character set 


DKU9103 

VIP 7200 console, 64-character set 


DKU9104 

VIP 7205 console, 96-character set 


TWU9104 

30CPS console typewriter 


TWU9106 

120CPS console typwriter 


TWU9108 

30CPS console with numeric keypad 


TWU9110 

120CPS console with numeric keypad 

Printer 

PRM9301 

M23 printer adapter 

Adapter 



Line 

PRU9103 

240LPM printer; 96-character set 

Printers 

PRU9104 

300LPM printer; 64-character set 


PRU9105 

440LPM printer; 96-character set 


PRU9106 

600LPM printer; 64-character set 


PRU9108 

660LPM printer; 96-character set 


PRU9109 

900LPM printer; 64-character set 

Matrix 

PRU9112 

Matrix printer; 120CPS 

Printers 

PRU9114 

Matrix printer; 160CPS 

Diskette 

DIM9301 

M23 diskette adapter 

Adapte r 



Diskettes 

DIU9101 

Single-diskette (single-sided); 

256KB 


DIU9102 

i 

! 

Dual-diskette (single-sided); 

2x256KB 


DIU9103 

Single-diskette (double-sided); 

512KB 


DIU9104 

Dual-diskette (double-sided); 

2x512KB 

Cartridge 

CDS9336 

26MB cartridge module disk in cabi¬ 

Module Disks 


net with 23 controller 


CDS9337 

2x26MB cartridge module disk in 
cabinet with 23 controller 


CDS9338 

80MB cartridge module disk in cabi¬ 
net with 23 controller 


CDS9339 

2x80MB cartridge module disk in 
cabinet with 23 controller 


CDU9136 

26MB cartridge module disk in cabi¬ 
net without controller 


CDU9137 

2x26MB cartridge module disk in 
cabinet without controller 
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Table C-l (cont) . Supported Hardware - Model 23 


Category 

Marketing 
Identifier 

Description 

Cartridge 

CDU9138 

80MB cartridge module disk in cabi- 

Module Disks 


net without controller 

(cont) 

CDU9139 

2x80MB cartridge module disk in 



cabinet without controller 

Communication 

DCM9301 

M23 communication adapter; 2 asyn- 

Adapters 


chronous lines 


DCM9302 

M23 communication adapter; 1 syn- 



chronous line 


DCM9303 

M23 communication adapter; 2 syn- 



chronous lines 


DCM9304 

M23 communication adapter; 1 syn- 



chronous and 1 asynchronous line 

Terminals 

Asynchronous 



Terminals 



VIP7100 

CRT terminal, 64-character set 


VIP7105 

CRT terminal, 96-character set 


VIP7200 

CRT terminal, 64-character set 


VIP7205 

CRT terminal, 96-character set 


VIP7801 

CRT terminal, 12-inch screen 


VIP7802 

CRT terminal, 15-inch screen 


VAF7821 

Buffered printer adapter for all 

' 


VIP 7800 terminals 


TWU1001 

Keyboard/printer, 30 cps 


TWU1003 

Keyboard/printer, 30 cps 


TWU1005 

Keyboard/printer, 120 cps 


PRU1001 

Printer terminal, 30 cps 


PRU1003 

Printer terminal, 30 cps 


PRU1005 

Printer terminal, 120 cps 


Synchronous 



Terminals 



VIP7700 

CRT terminal, 62-character set 


VIP7705 

CRT terminal, 95-character set 


VIP7700R 

CRT terminal, 63-character set 


VIP7705R 

CRT terminal, 95-character set 


VIP7760 

CRT terminal, 95-character set 


Subsystem 



VIP7804 

CRT terminal, 12-inch screen 


VIP7805 

CRT terminal, 15-inch screen 


VAF7821 

Buffered printer adapter for all 



VIP 7800 terminals 


ROP Printers 

ROP printers are generally supported 
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Table C-l (cont). Supported Hardware - Model 23 
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Table C-2. Hardware Supported - Model 3X, 4X and 5X 


Category 

Marketing 
Identifie r 

Description 

Central 

CPS9470 

Model 33 Central Processors; 

Processors 

CPS9471 

CPS9472 

CPS9473 

memory to 64K words 


CPS9560 

Model 43 Central Processors; 


CPS9561 

CPS9562 

CPS9563 

memory to 1024K words 


CPS 9 56 6 

Model 47 Central Processors; 


CPS9567 

Commercial Model; memory to 

1024K words 


CPS9570 

Model 53 Central Processors; 

includes MMU and Cache; memory 
to 1024K words 


CPS9572 

Model 57 Central Processor; 

Commercial Model with MMU and 
Cache; memory to 1024K words 

Multiple Device 

MDC9101 

Multiple device controller 

Controller 



Console 

KCM9101 

Keyboard console device-pacs 

Device-pac 


Consoles 

DKU9101 

VIP 7100 console 


DKU9102 

VIP 7105 console 


DKU9103 

VIP 7200 console 


DKU9104 

VIP 7205 console 


TWU9104 

300CPS console typewriter 


TWU9106 

120CPS console typewriter 


TWU9108 

30CPS console with numeric keypad 


TWU9110 

120CPS console with numeric keypad 

Printer 

PRM9101 

Printer device-pac 

Device-pac 



Line Printers 

PRU9103 

240LPM, 96-character set 


PRU9104 

300LPM, 64-character set 


PRU9105 

440LPM, 96-character set 


PRU9106 

600LPM, 64-character set 


PRU9108 

660LPM, 96-character set 


PRU9109 

900LPM, 64-character set 

Matrix 

PRU9112 

120CPS matrix printer 

Printers 

PRU9114 

160CPS matrix printer 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Category 

Marketing 

Identifier 

Description 

Card Reader 

CRM9101 

Card reader device-pac 

Device-pac 



Card Readers 

CRU9108 

300CPM 


CRU9109 

300CPM, IBM mark sense 


CRU9110 

300CPM, HIS mark sense 


CRU9111 

500CPM 


CRU9112 

500CPM, IBM mark sense 


CRU9113 

500CPM, HIS mark sense 

Card Punch and 

CRM9103 

Device-Pac for card punch and card 

Card Reader/ 


reade r/punch 

Punch Device- 
Pac (Adapter) 



Card Punch 

PCU9101 

Card punch, 100 cpm 

Card Reader/ 

CCU9101 

Card reader/punch, 400/100 cpm 

Punch 


Diskette 

DIM9101 

Diskette device-pac for 2 single- 

Device-pacs 


sided diskettes 


DIM9102 

Diskette device-pac for (2) 1- or 

' 


2-sided diskettes 

Diskettes 

DIU9101 

Single diskette (single-sided), 

256KB 


DIU9102 

Dual diskette (single-sided), 

2x256KB 


DIU9103 

Single diskette (double-sided) , 

512KB 


DIU9104 

Dual diskette (double-sided), 

2x512KB 

Cartridge Disks 

CDU9116 

10MB (5+5) cartridge disk with 
controller 


CDS9116 

10MB (5+5) additional disk without 
controller „ 

Cartridge 

CDS9136 

2bMB (13F + 13R) in cabinet with 

Module Disks 


controller 


CDS9137 

26MB in cabinet with controller 


CDS9138 

80MB (67F + 13R) in cabinet with 
controller 


CDS9139 

Dual 80MB in cabinet with 
controller 


CDU9136 

26MB in cabinet without controller 


CDU9137 

Dual 26MB in cabinet without 
controller 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Category 

Marketing 

Identifier 

Description 

Cartridge 

CDU9138 

80MB in cabinet without controller 

Module Disks 

CDU9139 

Dual 80MB in cabinet without 

(cont) 


controller 

CDS 9123 

26MB (13F + 13R) with controller 


CDS9125 

80MB (67F + 13R) with controller 


CDU9123 

26MB add-on unit without 
controller 


CDU9125 

80MB add-on unit without 
controller 

Mass Storage 

MSS9102 

Mass storage unit in cabinet with 

Units 


controller 


MSS9104 

256MB mass storage unit in cabinet 
with controller 


MSS9107 

Dual 67MB mass storage units in 
cabinet with controller 


MSU9102 

67MB mass storage add-on unit 
without controller 


MSU9104 

256MB mass storage add-on unit 
without controller 


MSU9107 

Dual 67MB mass storage add-on unit 
without controller 

Magnetic Tape 

MTC9101 

Magnetic tape controller, NRZI 

Controllers 


drives 


MTC9102 

Magnetic tape controller, PE/NRZI 
drives 

Magnetic Tape 

MTM9101 

Magnetic tape Device-Pac, 7-track 

Dev ice-Pacs 


drives 


MTM9102 

Magnetic tape Device-Pac, 9-track 
drives 

Magnetic Tape 

MTU9104 

Magnetic tape drive, 9-track NRZI, 

Drives 


45 inches per second (ips) 


MTU9105 

Magnetic tape drive, 9-track NRZI, 

7 5 ips 


MTU9109 

Magnetic tape drive, 9-track NRZI/ 
PE, 45 ips 


MTU9110 

Magnetic tape drive, 9-track NRZI/ 
PE, 75 ips 


MTU9112 

Magnetic tape drive, 7-track NRZI, 

45 ips 


MTU9113 

Magnetic tape drive, 7-track NRZI, 

75 ips 


MTU9114 

Magnetic tape drive, 9-track PE, 

45 ips 


MTU9115 

Magnetic tape drive, 9-track PE, 

75 ips 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Category 

Marketing 
Identifier 

Description 

Communication 

MLC9103 

Multiline communications processor 

Controllers 

MLC9101 

MLCP with 8 asynchronous lines; 
includes 4 communication-pacs 


MLC9102 

MLCP with 8 synchronous lines; 
includes 4 communication-pacs 


MLC9104 

MLCP with 8 current loop lines; 
includes 4 communication-pacs 

Communications- 

DCM9101 

Communications-pac, two asynchro- 

Pacs 


nous lines, cable 


DCM9102 

Communications-pac, one asynchro¬ 
nous line, cable 


DCM9103 

Communications-pac, two synchro¬ 
nous lines, cable 


DCM9104 

Communications-pac, one synchro¬ 
nous line, cable 


DCM9105 

Communications-pac, one current 
loop line (Bell 301/303 modem 
compatible) 


DCM9106 

Communications-pac, one medium 
speed, synchronous, HDLC line 


DCM9108 

Communications-pac, broadband line 
(CCITT/V35 compatible) 


DCM9109 

Communications-pac, two synchro¬ 
nous lines (MIL 188C compatible) 


DCM9110 

Communications-pac, Autocall Unit 
for one or two synchronous or 
asynchronous lines 


DCM9111 

Communications-pac, one asynchro¬ 
nous current loop line 


DCM9112 

Communications-pac, broadband B.DLC 
line (Bell 301/303 modem compat¬ 
ible to 72KB) 


DCM9113 

Communications-pac, broadband HDLC 
line (CCITT/V35 compatible to 

72KB) 


DCM9114 

Communications-pac, two asynchro¬ 
nous current loop lines 


DCM9115 

Communications-pac, broadband syn¬ 
chronous line (MIL 188C compat¬ 
ible to 56KB) 


DCM9116 

Communications-pac, two asynchro¬ 
nous lines (MIL 188C compatible) 


DCM9120 

Communications-pac, HDLC to 19 2KB 
MIL 188C 


DCM9121 

Communications-pac broadband HDLC 

MIL 188C 


DCM9126 

Communications-pac INCOTERM 
connection 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Category 

Marketing 

Identifier 

Description 

Terminals 

Asynchronous 



Terminals 



VIP7100 

CRT terminal, 64-character set 


VIP 710 5 

CRT terminal, 96-character set 


VIP7200 

CRT terminal, 64-character set 


VIP7205 

CRT terminal, 96-character set 


VIP7801 

CRT terminal, 12-inch screen 


VIP7802 

CRT terminal, 15-inch screen 


VAF7821 

Buffered printer adapter for all 



VIP 7800 terminals 


TWU1001 

Keyboard/printer, 30 cps 


TWU1003 

Keyboard/printer, 30 cps 


TWU1005 

Keyboard/printer, 120 cps 


PRU1001 

Printer terminal, 30 cps 


PRU1003 

Printer terminal, 30 cps 


PRU1005 

Printer terminal, 120 cps 


Synchronous 



Terminals 



VIP 77 0 0 

CRT terminal, 62-character set 


VIP7705 

CRT terminal, 95-character set 


VIP 77 0 OR 

CRT terminal, 63-character set 


VIP7705R 

CRT terminal, 95-character set 


VIP7760 

CRT terminal, 95-character set 


Subsystem 



VIP7804 

CRT terminal, 12-inch screen 


VIP7805 

CRT terminal, 15-inch screen 


VAF7821 

Buffered printer adapter for all 



VIP 7800 terminals 


ROP Printers 

ROP printers are generally 



supported 
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Table C-2 (cont). Hardware Supported - Model 3X, 4X, and 5X 


Category 

.— ' -- 

Description 

Modems 

Modems supported for asynchronous communications 
terminals are: 


• 

103, 113, 202 type modems. (These modems must be 
equipped with the option to disconnect the data set 
after a carrier drop of 110 milliseconds.) 


• 

Honeywell modem bypass. 


• 

Modem types where the connection, disconnection, and 
data set control settings can be user-specified. 


Modems supported for synchronous communications 
terminals are: 


• 

201, 201A, 201C, 208, and 208B type modems. 


• 

Honeywell modem bypass. 


• 

Modem types where the connection, disconnection, and 
data set control settings can be user-specified. 


• 

Broadband modem. 


A modem is not required for a direct-connect asynchro¬ 
nous terminal, or a synchronous terminal with a timing 
source in the terminal or in the MLCP. 

System 

Building 

Products 

Writable Control Store (CPF9509) is offered for system 
builder use only. Although Writable Control Store is 
usable under GCOS 6 MOD 400, full end-user software 
support is not available. 
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APPENDIX D 


POWER RESUMPTION 


NOTE: The Power Resumption facility is not supported on 

systems with an MLCP-connected operator's console. 

The power resumption facility allows the system execution 
environment to be restarted after a power interruption. The 
central processor must have the memory save and autorestart unit. 
This unit can preserve the memory image through a power failure 
lasting up to two hours. It cannot, however, preserve the state 
of the I/O controllers, ensure that no operational changes have 
been made to the mounted volumes, nor preserve the contents of 
the multiline communication processors. Restoration of this 
system information is accomplished through the power resumption 
facility. 

If fewer than two hours have elapsed when power is returned 
to the central processor, the power resumption facility performs 
the following actions: 

• Reinitializes the I/O controllers 

• Reconnects terminal devices (TTY and ATD devices) 

• Reestablishes the integrity of mounted volumes 

• Restarts the communications subsystem (TTY and ATD devices 
onl y) 

• Restarts the application tasks that were active at the 
time of the failure 

• Signals a power resumption software trap to tasks that 
have a handler enabled for this trap 

• Restarts Display Formatting and Control processing 
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If the power remains off for more than two hours, the memory 
image is destroyed and the power resumption facility is disabled. 
The "memory on" indicator contained in the memory save and auto¬ 
restart unit is lit. The operator must manually reset this indi¬ 
cator before rebootstrapping the system to perform a restart. 

See the Level 6 Minicomputer Systems Handbook for detailed infor¬ 
mation about the memory save and autorestart unit. See the 
Operator's Guide for procedures used in restarting after a system 
failure. 

POWER RESUMPTION CONFIGURATION REQUIREMENTS 


To implement the power resumption capability, you must, con¬ 
figure the following: 

• Memory save and autorestart unit 

• Power resumption facility 

• Automatic terminal reconnect 

Note that peripheral devices (those devices not attached to 
an MLCP) are designated automatically reconnectable when they are 
configured at system building. These devices are reconnected 
when power is restored. 

Configuring Memory Save and Autorestart Unit 


Four small rocker switches, located behind the full control 
panel on the control panel circuit board, supply configuration 
information to the central processor. The switch on the extreme 
left (when the panel is open) is the volatile memory switch. It 
must be set off (pushed down) to inform the system that the 
memory save and autorestart unit is present. 

NOTE: On some control panels, the volatile memory switch is 

on the extreme right. See the Level 6 Minicomputer 
Systems Handbook for complete details. 

Configuring Power Resumption Facility 

You add the power resumption facility to your system by 
including the following LDBU directive in the Configuration Load 
Manager (CLM) file. 

LDBU ZXPFR 

See Section 5 for a description of the LDBU directive. 
Configuring Automatic Terminal Reconnect 

Each communication device (each terminal connected to an 
MLCP) that is to be automatically reconnected by the power 
resumption facility must be so designated using the STTY command 
with the -RECONNECT argument in your CLM file. See the descrip¬ 
tion of the STTY command below. 
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STTY 
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STTY COMMAND 
Command Name: STTY 

Change or display the file characteristics of a communications 
terminal. Can be used as an alternative to the STTY directive 
format in the Configuration Load Manager (CLM) file. Provides 
features not supported by the STTY directive. You must include 
an STTY command in your CLM file for each terminal that you 
wish to configure as being reconnectable in the event of a sys¬ 
tem power failure. 

FORMAT: 

STTY [dev ice_name] ctl_arg 
ARGUMENT DESCRIPTION: 
device_name 

The 1- to 6-character device name of the terminal; use of 
the exclamation point character as a prefix is optional 
(e.g., TTY01 or ITTY01 can be used). 

Default: The terminal from which this command is issued. 

ctl_arg 

One or more of the following control arguments must be 
specified, in any order. If an argument is unspecified, 
the corresponding current value for the terminal remains 
in effect. 

-LL n 

Decimal integer specifying the desired line length. 

This value excludes the control byte. 


-TYPE 


Set the device type to input-only (I), output-only 
(0), or bidirectional (B). 
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TABSIM 


YES 

NO 


Insert space characters, where needed, to simulate 
tabbing. If the terminal does not support tabbing 
and the output data has tab characters, specify YES. 



Prepare the device to receive asynchronous buffered 
(A), synchronous buffered (S), or nonbuffered syn¬ 
chronous (N) input. (See the " Function Description" 
for a description of asynchronous, synchronous, and 
buffered.) 


OUT 


Prepare the device to transmit asynchronous buffered 
(A), synchronous buffered (S), or nonbuffered syn¬ 
chronous (N) output. (See the "Function Description" 
for a description of asynchronous, synchronous, and 
buffered.) 

RECONNECT (YES ) 


Specifies whether or not this terminal should be 
automatically reconnected following a power failure 
or line drop condition. If YES is specified, the 
terminal will be automatically reconnected. If NO is 
specified, no automatic reconnection will take place. 
The default is NO. - 

PRINT 

Display the current characteristics (name, device¬ 
type, line length, etc.) for the terminal. 
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-MODES mode 


{ 

{ 

t 

{ 

{ 

{ 

{ 

{ 


Set the terminal to operate in the specified mode(s). 
To reset a mode, precede the mode with a circumflex 
(") . For example, -MODES ECHO,"HANG UP sets the ter¬ 
minal to echo keyboard input and to r not" hang up the 
phone when the file is closed. Any number of modes 
can be set or reset in any combination, in any order. 
If a particular mode is not specified, that mode is 
not changed. Possible modes are listed below. To 
set a mode, you must know which line protocol handler 
(LPH) is servicing the terminal. The -PRINT argument 
can be used to display the current mode settings to 
determine which modes can be set or reset. 


Mode 

Meaning 

LPH 

ECHO 

Echo keyboard input. 

TTY, ATD 1 

AUTO CALL) 

AC f 

Use the Auto-Call unit when the 
file is opened. 

ALL 

transparent) 

TR j 

: Input data is in transparent 

' mode. 

TTY,ATD,BSC 

STOP OUTPUT) 

so ) 

> If an output order is in prog¬ 

ress, stop it immediately if a 

BRK is issued from the terminal. 

TTY,ATD 

LINE FEEDl 
LF J 

Line feed at end of message. 

TTY,ATD,VIP 
STD 

CARRIAGE RETURN) Carriage return at end of 

CR ; message. 

TTY,ATD,VIP 
STD 

CONTROL_BYTE) Output sent to the terminal 

CB f starts with a control byte. 

TTY,ATD,VIP 
STD, BSC 

BLK XFER) 

BLK f 

Data transfer is in buffered 
(block) mode, not character 
mode . 

TTY,ATD 

HANG UP) 

HU / 

Hang up the phone when the file 
is closed. 

ALL 

HOME 

Set cursor to home on page 
overflow. 

VIP,STD 


i The ATD LPH is intended as a replacement for the 
protocol handler called by ATD offers additional 
bilities (e.g., block mode support of VIP7801/02 
port of the VIP7207 device) not offered by the line protocol 
handler called by V7200. The V7200 LPH may still be used. 


V7200 LPH. The 
support capa- 
devices, sup- 
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Mode 


Meaning 


LPH 


FCTN 

Support 

VIP function codes. 

VIP,STD 

DEL 

Include 

received DEL characters. 

PVE 


The following special keywords can be used with 
the VIP line protocol handler to set various 
time-out and polling intervals: 

TO 

Time-out 
poll). 

immediately (after 1 

VIP,STD 

TOIO 

Time-out 

polling. 

after 10 minutes of 

VIP,STD 

o 

< 

No time- 

out (i.e., indefinite). 

VIP,STD 

"PI 

No polling interval (i.e. , 
continuous). 

VIP,STD 

PI1 

1-second 

poll interval. 

VIP,STD 

PI 2 

2-second 

pol1 interval . 

VIP,STD 

PI 3 

3-second 

poll interval. 

VIP,STD 

PI 4 

4-second 

poll interval . 

VIP,STD 

PI 5 

5-second 

poll interval. 

VIP,STD 

PI 15 

15-second poll interval. 

VIP,STD 

PI 30 

30-second poll interval. 

VIP,STD 


-RESET 

Reset the modes to those designated at system 
buiId ing . 

DSW1 h 

Set the terminal's device-specific word to be used at 
open (connect) and close (disconnect) time; this 
argument is an alternative to using the -MODES argu¬ 
ment. h is a 4-character hexadecimal value. This 
argument requires detailed knowledge of terminal I/O 
and should be used only if you understand line proto¬ 
col handlers and have read the Communicat i ons 
Processing manual. 


zf 


D-6 


CB23-03 


-DSW2 h 


Set the terminal's device-specific word to be used 
when the file is read or written; this argument is an 
alternative to using the -MODES argument. h is a 4- 
character hexadecimal value. This argument requires 
detailed knowledge of terminal I/O and should be used 
only if you understand line protocol handlers and 
have read the Communications Processing manual. 

NOTES: 1. Only the current device-specific word 

assignments can be modified; i.e., not 
the initial device-specific words estab¬ 
lished through the STTY directive during 
system building. 

2. No consistency checks are made; if the 
-DSW1 or -DSW2 argument specifies logi¬ 
cally inconsistent or impossible condi¬ 
tions, relative to the actual device 
type, no notification of error is given 
and the indicators are set as requested. 

FUNCTION DESCRIPTION: 

The set terminal characteristics (STTY) command permits you 
to modify or display the file characteristics associated with 
a terminal or endpoint that is not currently reserved. The 
original terminal characteristics, established during system 
building, can be altered to reflect your current needs. To 
use the -IN and -OUT arguments, you must understand the 
meanings of the terms buffered, asynchronous, and synchro¬ 
nous. These terms are described below. 

Buffered means that an intermediate data storage area is used 
before data is transferred to/from a device. For input, data 
is received in system memory and then moved to user memory. 
For output, data is moved from user memory to system memory 
and then to the device. Nonbuffered means that data is 
transferred directly from user memory to the device. 

Asynchronous data transfer is the concurrent transfer of data 
and execution of an application program; i.e., processing can 
continue during a read/write operation. Asynchronous opera¬ 
tions are always buffered. 

In synchronous data transfers, processing waits for comple¬ 
tion of a read/write request. Control returns to the 
requestor after the transfer is complete. Synchronous opera¬ 
tions may be buffered or nonbuffered. 
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The operating characteristics of the application program 
determine whether asynchronous buffered (A), synchronous 
buffered (S) , or synchronous nonbuffered (N) are specified in 
the -IN and -OUT arguments. Generally, if an application 
program is directed towards multiple terminals, specify A so 
there is full user interaction. If S or N is specified and 
someone issues a read or write, all other users have to wait. 
This is explained in more detail below. 

With asynchronous input, if an application program issues a 
read request, the system waits for previous read operations 
to complete. The data is moved to the application program, 
the read request just issued is placed in a queue, and con¬ 
trol immediately returns to the application program. If the 
application program is interacting with only one terminal, 
asynchronous input is efficient, but not necessary; the 
application program can process a message while the file 
system reads the next message. Asynchronous input is neces¬ 
sary for an application program to interact with multiple 
terminals. For multi terminal applications, an application 
program may poll terminals and wait for input from a list of 
terminals. 

Asynchronous output permits "double buffering" output 
requests. When an application program issues a write 
request, the system waits for previous write requests to 
complete. Data is moved from the application program to a 
system buffer, the write request is placed in a queue, and 
control immediately returns to the application program. 

NOTE: For sing1e-termina1 applications using the roll-out 

feature, A or S provides more efficient operation. 


Example: 

STTY 1VIP01 -MODES ~CONTROL_BYTE,~ STOP_OUTPUT, 
AUTO_CALL,~HANG_UP 

or 

STTY VIP01 -MODES ~CB,~SO,AC,~HU 

File input/output to VIP01 will not expect a w control byte 
before each output message. Finish printing output message 
that may be in progress when a BREAK is detected. Use the 
Auto-Call unit when the file is opened. Do not hang up the 
phone when the file is closed. 
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ACTIONS FOLLOWING POWER RESUMPTION 


When the power resumption facility restarts the execution 
environment, it automatically performs a number of system func¬ 
tions. When the operator and system users are notified that 
power resumption has occurred, they may be required to perform 
certain actions. 

Automatic Functions 


The power resumption facility automatical1y performs the 
following functions: 

• Restarts the device drivers, clock, and communications 
subsystem. 

• Reconnects peripheral devices. Reconnects terminal 
devices that were designated as being automatically 
reconnec table. 

• Resets the system date and time. (The date/time clock has 
a separate battery backup unit; it is supported through 
the real-time adapter.) 

• Reloads the memory management unit. 

• Restarts all tasks that were active when the power failure 
occurred. 

In addition to these automatic functions, the system operator 
and system users may be required to perform certain actions. 

These power resumption procedures are described in the Operator 1 s 
Guide. 
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APPENDIX E 


( 


DATA ENTRY FACILITY - I 


This appendix describes a typical configuration procedure 
that can be used to accommodate DEF-I, and lists the Linker 
directives that are required to link a DEF-I system. 

CONFIGURATION 

GCOS 6 MOD 400 software requires that the following steps be 
performed before the Data Entry Facility-I can be used: 

1. During system building, ensure that the directives 
required by the DEF-I system are included in the 
CLM USER f ile . 

f 

2. Generate a DEF-I system Linker directive file that sup- 
supports the user's CLM_USER file. 

NOTE: To aid in steps 1 and 2, a sample DEF-specific 

Linker directive file (DEF_SAMPLE.S) is supplied 
on the media. It may be modified to meet the 
requirements of the particular installation. 

3. Execute a Linker run to produce a DEF-I bound unit. 

4. Optionally, execute a Linker run to produce a user- 
supplied data entry program. 

5. Generate the appropriate DEF-I system user group and 
Start-Up task command files. 

To aid in an understanding of this process, a sample DEF-I 
system configuration is used throughout this appendix. 
Configuration parameters {include: 

• 4 operator display stations 

• 1 line printer 

• 1 data entry program overlay area 

• 2 DEF-I background tasks 

( 
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CLM-USER FILE 


After the GCOS 6 MOD 400 system has been initially loaded by 
a stage 1 system startup, you must define a file of configuration 
directives, called the CLM_USER file, for the Configuration Load 
Manager (CLM). This file will contain the symbolic peripheral 
device names (SPD), communications arguments, and memory pool 
assignments necessary to use GCOS 6 MOD 400 software on a Level 6 
system. 

The CLM_USER file directives need not be completely DEF- 
specific. That is, the devices, memory, etc., described in the 
CLM_USER file may be shared by other system function facilities 
and may include specifications not required for the Data Entry 
Facility-I. 

Sample CLM-USER File 

Figure E-l illustrates a CLM_USER file for a Data Entry 
Facility. The file specifies a system with four operator display 
stations, one attached through an MDC (CONOl) and three attached 
through an MLCP/DLCP (TTX). Additionally, there are two 
diskettes and a line printer. (The bootstrap device is left 
implicit here.) 


DEVICE KSR00,0,5,X'0500' ,CONSOLE, 140 
COMM 7 

TTX 12,8,X 1 FF00' ,0,9600 
TTX 13,9,X'FF80' ,0,9600 

DEVICE CONOl,14,10,X'058 0' ,CON01,80,N , ’7200' ,T 
TTX 15,11,X'FE80',0,9600 
PV' 16,16,X'FC00',2,00 


Figure E-l. Sample CLMJJSER File 
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PVE 17,16,X'FCOO',2,01 
DEVICE DSKOO,5,14,X'0400 ' 

DEVICE DSKOI,6,15,X'0480' 

DEVICE LPT00,8,17,X*1380',LPT00 
MEMPOOL S, ,6000 
MEMPOOL ,AB , * 

SYS ,,,5,20,80,,E 
QUIT 


Figure E-l (cont). Sample CLM_USER File 
CLM USER File D i re ct ives 

The following CLMJJSER file directives are used for a system 
that includes DEF-I. 

DEVICE DIRECTIVE 

A DEVICE directive is required for each device--except a 
communications (MLCP/DLCP-connected) operator display station— 
used with DEF-I. (A DEVICE directive may be paired with a TTX 
directive used for a communications operator display station if 
the device is to be accessible through the file system inter¬ 
face.) The DEVICE directive is described in Sections 5 and 6; 
in addition, note the following points: 

• A noncommunications (MDC-connected) operator display 
station requires the device arguments specifying non- 
buffered teletype mode of the DEF-I workstation be used 
(see Section 5). 

• If a DEVICE directive is paired with a TTX directive 

(described below), the DEVICE directive's device_unit 
argument value must be TTYnn (see Section 6 to ascertain 
the device characteristics achieved by TTYnn). For 
example: » 


DEVICE TTY00,15,11,X'FE80',TTY00,80 

Table E-l lists the devices configured in Figure E-l and 
their associated device unit argument values. 
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Table E-l. 


Devices Configured in Figure E-l 


Device Type 

Number 
Config ured 

Device Unit 
Argument Values 

Console 

1 

KSROO 

Operator Display 
Station—-MDC- 
connected TTY 

1 

CON 01 

Diskette 

2 

DSK00, DSK01 

Line Printer 

1 

LPT00 


When more than one operator display station is configured 
for DEF-I, those CRT's must be assigned consecutive logical 
resource numbers (LRN's) . Similarly, all system line printers 
used by DEF-I must be assigned consecutive LRN's. 

In Figure E-l, the four operator display stations use the 
sequential LRN's 12, 13, 14, and 15. 

Also note that the number of devices configured in the 
CLM_USER file may be greater than those specified when linking 
the DEF-I system (see below). Thus the DEF-I bound unit may be 
linked for three CRT's even if the CLM_USER file specifies four. 

COMMUNICATIONS SYSTEM DIRECTIVE 

The COMM directive specifies that a communications subsystem 
is used. In Figure E-l, the communications subsystem is given a 
hardware interrupt level of 7. High priority hardware levels 
should be used for communications interrupts to ensure satisfac¬ 
tory operation. 

TTX DIRECTIVE 

The TTX directive specifies a TTY-type communications 
device. However, unlike the TTY directive, it provides an 80- 
character buffer. This buffer, and therefore the TTX directive, 
is required for all DEF-I operator display stations attached 
through an MLCP/DLCP. 

The TTX directive appears as follows: 

TTX lrn ,level,X'channel' ,[modem] [,speed] 

Refer to the TTY directive in Section 6 for a description of 
the TTX arguments. 

In Figure E-l, there are three MLCP/DLCP connected operator 
display stations, and therefore three TTX directives. 
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MEMORY POOL DIRECTIVES 


A MEMPOOL directive is used to specify the system memory 
pool size. Additionally, an online user memory pool—either 
exclusive or nonexclusive—must be specified for the DEF-I sys¬ 
tem. The minimum required size depends upon which DEF-I system 
functions are linked as resident and which are overlays, and upon 
the number of DEF-I workstation buffers required. Memory 
requirements are further described under "Linking a DEF-I System" 
below. The MEMPOOL directive is described in Section 5. 

In Figure E-l, the DEF-I system is configured with a single 
nonexclusive online memory pool with the name AB; this pool ex¬ 
tends from the end of the system memory pool to high memory. This 
single pool can be used by the DEF-I system and by any other 
function in a group assigned to this pool, e.g., the COBOL 
compiler. 

SYSTEM DEFINITION DIRECTIVE 

The SYS (system definition) directive is described in 
Section 5. The following consideration applies to DEF-I. 

It is advisable to create several system overlay areas to 
improve the likelihood that a needed overlay is already present 
in memory (because it was recently used) and does not have to 
be reloaded. This is done through the "olan" argument of the 
SYS directive; 5 is a recommended value. 

It is also recommended that the user allocate additional 
interrupt request blocks for each DEF-I workstation. In Fig¬ 
ure E-l, 80 interrupt request blocks have been added for four 
workstations. This configuration supports activities in a high- 
throughput data entry environment. In a more casual data entry 
environment, approximately 10 additional interrupt request blocks 
per workstation would be adequate. 

LINKING A DEF-I SYSTEM 

The following paragraphs describe the requirements for 
linking: 


• A DEF-I system bound unit 

• A DEF-I data entry programs bound unit 

The Linker directives are discussed in the Program Executive and 
Checkout manual. 

DEF-I System Directories 

The DEF-I system object units are located in the directories 
listed in Table E-2, depending upon the system software medium. 
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Table E-2. DEF-I Object Unit 
Directory Pathname 


Medium 

Directory Pathname 

Diskette 

Cartridge Disk 

Mass Storage Unit 
Cartridge Module Disk 

~ ZSYS10>ZDRT 
~ZSYS 51>ZDRT 
~ZSYS71>ZDRT 
~ZSYS61>ZDRT 


DEF System Object Units 

The DEF system object units are grouped in Table E-3 accord¬ 
ing to function. Some of these units are linked internally, and 
do not need to be specified when linking DEF-I. 


Table E-3. DEF-I Object Units 



Object Units 

Function 

Specified 

Not Specified 


System Object Units 

DEF-I Control 

ZDFLTD, 

ZDFCRT, ZDFINI, ZDFSTB, 


ZDFCTL 

ZDFDDH, ZDFBM, ZDFPH, 


ZDFIAD 

ZDFPRW, ZDFOLY, ZDFMSG, 



ZDFLTH, ZDFSR1, ZDFLOK, 



ZDFSRD 

Background Control 

ZDFBGR 


Operator Security 

ZDFOSR 


Operator Statistics 

ZDFSTA 


Function Object Units 

Applications Processor 

ZDFAP 


Data Entry Processor 

ZDFDE1 

ZDFDE2, ZDFDE3, ZDFDE4 

Forms Processor 

ZDFFM1 

ZDFFM2, ZDFFM3, ZDFFM4, 



ZDFFM5 

File Print Processor 

ZDFFP 


Tables Processor 

ZDFTB 


Utility Functions 

ZDFUT 


Supervisor Functions 

ZDFSP1, ZDFSP2, 



(ZDFPUP) 


Verification Processor 

ZDFVE 



E-6 


CB23-03 





Additionally, dummy units listed in Table E-4 are provided 
so that specific DEF-I functions such as operator security, 
operator statistics, and password updating need not be included 
in the system. 


Table E-4. DEF-I Dummy Object Units 


Function 

Dummy Object Unit 

No Applications 

ZDFAPD 

No Data Entry 

ZDFDED 

No Form Creation 

ZDFFMD 

No File Printing 

ZDFFPD 

No Table Creation 

ZDFTBD 

No Utilities 

ZDFUTD 

No Supervisor 

ZDFSPD 

No Verification 

ZDFVED 

No Operator Security 

ZDFOSD 

No Operator Statistics 

ZDFSTD 

No Password Updating 

ZDFPUD 


(Not required if 
Supervisor is not 
configured.) 


To create the DEF-I system bound unit, either the real unit 
or the corresponding dummy unit must be included for each 
function. For example, you must link either ZDFFP or ZDFFPD. 

Data Entry Program Object Units 

All data entry programs are optional user-supplied programs 
that are linked into one or more bound units separate from the 
DEF-I system bound unit. Table E-5 lists the object units that 
must be linked in order to process data entry programs. These 
object units are linked with the data entry programs in a Linker 
run separate from the linking of the DEF I bound unit itself. 
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Table E-5. DEF-I 

Data Entry Program 

Obj ect 

Units 

Function 

Object Unit 

Memory Resident 

ZDFMR 

Data Entry Program 
Director 


Data Entry Program Overlay 

ZDFD1, ZDFD2, ZDFD3, ZDFD4 

Directors 


Data Entry Program Dope 

ZDFDVG 

Vector Generator 



Bound Unit Organization Considerations 

Before generating a DEF-I bound unit, you should consider 
the following questions: 

• Which DEF-I functions are required? 

• Which DEF-I functions may be overlayed? 

• Is the operator security feature required? 

• Is password updating required? 

• Are operator statistics required? 

The available DEF-I functions are as follows: 

• Applications Processing 

• Data Entry Processing 

• Forms Generation 

• File Printing 

• Table Generation 

• Utility Functions 

• Supervisor Functions 

• Verification Processor 

If Data Entry is configured you must also consider whether 
user-supplied data entry programs are required. 

RESIDENT AND OVERLAYED FUNCTIONS 

Each DEF-I function may be linked as memory resident or 
overlayed. Functions linked as overlays are not necessarily 
available to the display station operator at all times. Figure 
E-2 illustrates three possible DEF-I system bound unit organiza¬ 
tions. The first one is the bound unit as linked by DEF_SAMPLE.S 
in Figure E-7. Here, only the DEF-I control function is resident 
and the remaining functions are overlays. Functions which share 
a common overlay base address cannot be used concurrently. That 
is, it would not be possible to use the data entry and forms 
functions at the same time, but it is possible to use .the data 
entry and verification functions concurrently. It would not be 
possibly to use the interactive and supervisor functions at the 
same time because the data entry function is loaded into memory zf 

when the verification function is selected and the data entry and 


E-8 


CB23-03 





( 


supervisor functions have a common base address. Note that the 
effect of linking the application function so that it is never 
overlayed by any other function would be to leave it always in 
memory once it or any of the other functions has been used. This 
has the same effect as linking the applications function as 
memory resident. The size of this particular DEF-I system bound 
unit would include the sum of the sizes of the DEF-I control, 
applications, data entry, and verification functions. 

The second bound unit organization in Figure E-2 allows more 
functions to be accessed concurrently. Here it would be possible 
to use the applications, file print, data entry, forms, and 
tables functions all at the same time. In this particular 
organization, the size of the bound unit is greater than the size 
of the first illustration but the difference is only by the size 
of the file print function. 

The third DEF-I bound unit organization in Figure E-2 would 
take up considerably less memory but available functions are 
limited. This organization would be suitable once you have 
created all necessary forms and tables for data entry and had no 
further use for those or any other functions. 

When planning the DEF-I function overlays, you must consider 
which functions are required to run concurrently in the system 
and arrange the overlays accordingly. Use of concurrent func¬ 
tions causes the size of the DEF-I system bound unit to increase 
according to the size of the concurrent functions. 

If a function is linked as an overlay but is not overlayed 
by any other function, it will be read into memory when first 
selected and remain in memory for the duration of the DEF-I task 
group. 

DATA ENTRY PROGRAMS 

All data entry programs are user-supplied and linked into 
one or more bound units separate from the main DEF-I system bound 
unit. 


Data entry programs can be made memory resident for speed of 
access or overlayed if sufficient memory is not available. 


The linkage procedure for user programs is described in the 
Data Entry Facility-I User's Guide. 
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RESIDENT FUNCTIONS 


DEF CONTROL 


DEF CONTROL 


OVERLAY AREA FOR FUNCTIONS 
$ 

APEND + X'V 
DEEND + X'50' 



A 

D 

F 

P 

S 

T 

U 

V 


LEGEND 

APPLICATIONS 
DATA ENTRY 
FORMS 
FILE PRINT 
SUPERVISOR 
TABLES 
UTILITIES 
VERIFICATION 




DEF CONTROL* 

D 

3 


S 

l\ 





FMEND + X'V 
SPEND + X'V 

(LABEL AT END OF RESIDENT FUNCTIONS) 


DEEND + X'50' 

(LABEL AT END OF RESIDENT FUNCTIONS) 


* Includes dummy object units for functi 3ns not available. 


Figure E-2. DEF-I Function Resident/Overlay Organizations 
MEMORY CONSIDERATIONS 

The following memory considerations must be kept in mind 
when deciding the DEF-I system bound unit organization. 
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The amount of memory required for the DEF-I system bound 
unit includes the memory required for the resident functions plus 
the memory required for all overlayed functions that can reside 
in memory simultaneously. When all overlays start at the same 
base address, this memory size is that of the largest overlay. 

When a given function is processing either as resident 
or as an overlay, all operator display stations can access that 
function concurrently (the function is reentrant). 

User-written data entry programs are linked separately from 
the DEF-I system bound unit and have their own overlay structure. 
Up to four bound units of overlayed data entry programs are sup¬ 
ported. The user may link up to 99 different data entry overlay 
programs in each bound unit or overlay area. The amount of 
memory available must be large enough to contain the largest data 
entry overlay program. User-written data entry programs can also 
be linked as memory resident. If so, they are linked into a 
single, separate bound unit. Memory is required for the data 
entry program director plus the sum of the sizes of all user pro¬ 
grams up to a maximum of 20 programs. 

Additional buffer and system memory considerations are 
discussed later in this appendix. 

DEF-I System Bound Unit Creation 

Creation of the DEF-I system bound unit consists of a Linker 
run using a file with Linker directives that define four 
logical system categories: 

• DEF-I system object units 

• DEF-I memory resident DEF-I function object units 

• DEF-I overlayed DEF-I function object units 

• DEF-I system parameters 

Figure E-7 is a complete listing of sample Linker directives 
required by a DEF-I system. In the linking procedure described 
below, the directives in that listing are used to illustrate the 
text. 

LINKING DEF-I SYSTEM OBJECT UNITS 

V 

Only the DEF-I system object units listed in Table E-5 must 
be linked. The remaining system object units listed in E-3 are 
internally linked and do not need to be specified. 
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Table E-6. System Object Unit Linker Directives 


Function 

Linker 

Directives 

System Routines: 

DEF-I Control and 
Background control 

LINKN ZDFCTL, ZDFBGR, ZDFLTD, ZDFIAD 


Configured 

Not Configured 

Operator Security 

LINKN ZDFOSR 

LINKN ZDFOSD 

Operator Statistics 

LINKN ZDFSTA 

LINKN ZDFSTD 


LINKING MEMORY RESIDENT DEF-I FUNCTION OBJECT UNITS 

If a configured DEF-I function is to be memory resident or 
if it is to be omitted from the DEF-I system, a Linker directive 
listed in Table E-7 must be used. 


Table E-7. Memory Resident Object Unit Linker Directives 1 


Function 

Memory Resident 

Not Configured 

Applications Processor 

LINKN ZDFAP 

LINKN ZDFAPD 

Data Entry Processor 

LINKN ZDFDE1 

LINKN ZDFDED 

Forms Processor 

LINKN ZDFFM1 

LINKN ZDFFMD 

File Print Processor 

LINKN ZDFFP 

LINKN ZDFFPD 

Tables Processor 

LINKN ZDFTB 

LINKN ZDFTBD 

Utility Functions 

LINKN ZDFUT 

LINKN ZDFUTD 

Supervisor Functions 

LINKN ZDFSP1, 
ZDFPUP, ZDFSP2 
(See note 2) 

LINKN ZDFSPD, ZDFPUD 

Verification Processor 

LINKN ZDFVE 

LINKN ZDFVED 


Notes: 1. Several of the object units listed in Tables E-3 and 

E-4 for the functions in this table do not have to 
be specified in the LINKN directives because they 
are internally linked. 

2. If the supervisor function is linked and password 

updating is not required, specify ZDFPUD in place of 
ZDFPUP. 
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LINKING DEF-I FUNCTION OVERLAY OBJECT UNITS 

Linker directives are required to link overlayed DEF-I func¬ 
tions, if any. For each function, use Linker directives to: 

1. Name the overlay 

2. Specify the base 

3. Link the function object units 

4. Protect the overlay base and end addresses. 

Table E-8 lists the DEF-I system functions and the directives 
required to link each as an overlay. 


Table E-8. DEF-I Function Overlay Linker Directives 


Function 

Overlay Directives 

Application Processor 

0VLY APOLAY 

BASE- 

LINKN ZDFAP 

PROT APBASE,APEND 

Data Entry 

OVLY DEOLAY 

BASE- 

LINKN ZDFDE1 

PROT DEBASE,DEEND 

Forms Processor 

OVLY FMOLAY 

BASE- 

LINKN ZDFFM1 

PROT FMBASE,FMEND 

File Print 

OVLY FPOLAY 

BASE- 

LINKN ZDFFP 

PROT FPBASE, FPEND 
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Table E-8 (cont). DEF-I 

Function Overlay Linker Directives 

Function 

Overlay Directives 

Supervisor Functions 

OVLY SPOLAY 

BASE- 

LINKN ZDFSP1,ZDFPUP,ZDFSP2 

PROT SPBASE,SPEND 

Table Generation 

OVLY TBOLAY 

BASE- 

LINK ZDFTB 

PROT TBBASE,TBEND 

Utility Functions 

OVLY UTOLAY 

BASE- 

LINKN ZDFUT 

PROT UTBASE,UTEND 

Verification 1 

OVLY VEOLAY 

BASE- 

LINKN ZDFVE 

PROT VEBASE,VEEND 


Note: 


!• The verification function requires data entry 
processor subroutines. Therefore, its base 
starting address must follow the last data 
entry overlay address, DEEND. 

The BASE directive must be set up according to the user re¬ 
quired overlay structure. Refer to the Program Execution and 
checkout manual for a full discussion of the BASE directive. 
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If patches are applied to any DEF-I function object unit and 
the end address of that function is used as the base address for 
overlayed DEF-I functions, then the base address for that over- 
layed function should be specified as: 

[function id] END + X'50' 

where [function id] is one of the two-character abbreviations 
shown above. 

Each overlay has "start" and "end" labels which must be 
1 PROTected 1 as shown. 

Figure E-7 is a sample listing of the Linker directives 
necessary to specify the DEF-I system and function object units. 

DEFINING DEF-I SYSTEM PARAMETERS 

Additional Linker directives are required to provide DEF-I 
system parameter values. The values must be placed in the half 
of a word as illustrated. 

A complete listing of the examples that illustrate the text 
is in Figure E-7. 

Specifying LRNs 

The following directives specify sample logical resource 
numbers (LRNs) required for DEF-I. Unless otherwise mentioned 
these LRNs are not related to system-wide LRNs (e.g., those in 
the CLMJJSER file). 

Pirective Comment 

VDEF DKLRN,X'0100' /LRN OF DISK HANDLER=1 

VDEF BMLRN,X'0200' /LRN OF BUFFER MANAGER=2 

VDEF LOKLRN,X'0300' /LRN OF DEF FILE LOCKER=3 * 

VDEF INILRN,X'0500' /LRN OF CRT1 = 5 

VDEF LOLRN,X'0019' /FIRST(=25) AND LAST (=X'1A'=26) LRNS 

VDEF HILRN,X'001A' /FOR BACKGROUND AND OPERATIONS. * 

2 OPERATIONS ARE ALLOWED IN THIS 
EXAMPLE. 

VDEF CRLRN1,X 1 0' /LRN OF MEMORY RESIDENT PROGRAM 

DIRECTOR =0 (NO MEMORY RESIDENT 
PROGRAMS) 

VDEF OVLRN1,X'1B00' /LRN OF DATA ENTRY PROGRAM OVERLAY 

DIRECTOR 1 =X 1 IB'=27 DECIMAL 
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Directive 


Comment 


VDEF 

OVLRN 2 , X ' 0 1 

/LRN OF DATA 
DIRECTOR 2=0 

ENTRY PROGRAM 
(OVERLAY AREA 

OVERLAY 

NOT USED) 

VDEF 

OVLRN3,X'0 ' 

/LRN OF DATA 
DIRECTOR 3=0 

ENTRY 

PROGRAM 

OVERLAY 

VDEF 

OVLRN4,X'0 ' 

/LRN OF DATA 
DIRECTOR 4=0 

ENTRY 

PROGRAM 

OVERLAY 

Note 
LRNs of 0 

that data entry 
because they are 

overlay directors 2 
not being used. 

through 

4 are given 


The LOLRN, HILRN arguments define the range of LRNs to 
execute file prints and applications in the background. In the 
example above, two LRNs are available which would allow two back¬ 
ground file prints, two background applications, or one of each. 

Specifying the Number of Function Overlays 

The following directive specifies the number of OVLY direc¬ 
tives used in linking the DEF-I functions. 

Directive Comment 

VDEF OLYNO,X 1 0008 1 /Number of function overlays = 8 
Specifying the Size of the CRT Screen 

The following directives specify the dimensions of the 
screen of the operator display station. The forms processsor 
will not permit fields on a form to be created outside of the 
positions specified here. The size of the CRT screen must be 
specified as follows: 

Directive Comment 

VDEF CRTC,X'0050 1 /COLS PER CRT LINE X'50'=80 

DECIMAL 

VDEF CRTL,X'0017 1 /LINES PER CRT PAGE X'17'=23 

DECIMAL 

Specifying Continuous or Noncontinuous Keyin 

The following directive specifies whether keying is con¬ 
tinuous; that is, whether the system will tab forward automati¬ 
cally between fields or whether the RETURN key must be entered 
to reach the next field. 
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Directive 


Comment 


VDEF NCONKN,X'0' /X'0' MEANS CONTINUOUS, NON X'O' 

MEANS NONCONTINUOUS KEYIN. 


AUTCAL Argument 

This argument is required and is reserved for system use: 

VDEF AUTCAL,X'0000' / RESERVED 

CLM_USER-Related Directives 

The following directives are specified in the CLM_USER file. 
They define the following: 

1. The LRN of the first DEF-I CRT. The value must match 
the lowest LRN value specified in the CLM_USER file for 
a device to be used as an operator display station. In 
the example, the X'OCOO' corresponds to the (decimal) 

12 in Figure E-l. 

Directive Comment 

VDEF CRTLRN, X'OCOO' /LRN OF FIRST CRT DRIVER = 12 DECIMAL 

2. The LRN of the first printer used by DEF-I. The value 
must match the lowest LRN value specified in the 
CLM_USER file for a printer to be used with DEF-I. In 
the example, the X'0800' corresponds to the (decimal) 

8 in Figure E-l. 

Pirective Comment 

VDEF PRTLRN, X'0800' /LRN OF FIRST PRINTER DRIVER 

3. The presence or absence of an operator console. A value 
of X'0059' (ASCII Y) in the VDEF OPCONS directive indi¬ 
cates that a console is present; a value of X'004E' 
(ASCII N) indicates that there is no console. 

Pirective Comment 

VDEF OPCONS, X'0059' /ASCII, Y, OPERATOR'S CONSOLE 

IS PRESENT 

4. The number of CRT's available as DEF-I operator display 
stations. Note that this number must not exceed the 
number of CRT's specified in the CLM_USER file. 

Directive Comment 


VDEF CRTNO, X'0004' /NUMBER OF CRT'S SUPPORTED 
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5. The number of printers available to DEF-I. 

Directive Comment 

VDEF PRTNO, X'0001' /NUMBER OF PRINTERS=1 

* 

Printer Formatting 

The following directives define the number of characters per 
line and the number of lines per page for each printer. Note 
that 16 directives must be present, even if only one printer is 
used. 

VDEF PRTC1,X'0088' /PRINTER 1 LINE WIDTH=136 DECIMAL 

characters (hexadecimal 88) 

VDEF PRTL1,X'003E 1 /PRINTER 1 LINES/PAGE=62 DECIMAL 

(Hexadecimal 3E) 

VDEF PRTC2,X'0088' /PRINTER 2 LINE WIDTH=136 

VDEF PRTL2,X'003E' /PRINTER 2 LINES/PAGE=62 

VDEF PRTC3,X'0088' /PRINTER 3 LINE WIDTH=136 

VDEF PRTL3,X 1 003E' /PRINTER 3 LINES/PAGE=62 

VDEF PRTC4,X'0088 1 /PRINTER 4 LINE WIDTH=136 

VDEF PRTL4,X 1 003E' /PRINTER 4 LINES/PAGE=62 

VDEF PRTC5,X'0088' /PRINTER 5 LINE WIDTH=136 

VDEF PRTL5,X'003E' /PRINTER 5 LINES/PAGE=62 

VDEF PRTC6,X 1 0088' /PRINTER 6 LINE WIDTH=136 

VDEF PRTL6,X'003E' /PRINTER 6 LINES/PAGE=62 

VDEF PRTC7,X'0088' /PRINTER 7 LINE WIDTH=136 

VDEF PRTL7,X'003E' /PRINTER 7 LINES/PAGE=62 

VDEF PRTC8,X'0088' /PRINTER 8 LINE WIDTH=136 

VDEF PRTL8,X'003E' /PRINTER 8 LINES/PAGE=62 
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Fixed Buffer Allocation 


Each active operator 
tain amount of workspace, 
a constant memory storage 
space requirements depend 
and are provided by a set 
buffers are requested as 


display station (CRT) requires a cer- 
For example, each active CRT requires 
area of 357 words. The remaining work- 
upon the function executing at the CRT 
of fixed and dynamic buffers. Dynamic 
they are needed from the user pool. 


Fixed buffers must be specified using Linker directives. There 
are four sizes of DEF-I fixed buffers specified using the VDEF 
directive NB1, NB2, NB3, and NB5 arguments, 
are listed in Table E-9. 


These buffer sizes 


Table E-9. DEF-I Fixed Buffer Sizes 


Buffer Argument 

; 

Buffer Length (Words) 
Decimal 

NB1 

1024 

NB 2 

256 

NB3 

Config urable 

NB5 

10 

Buffer argument 

NB4 is reserved. 


Depending upon the particular application executing at the 
CRT some of the DEF-I fixed buffers are used only temporarily and 
are returned to the DEF-I fixed buffer pool as soon as their use 
is completed. The buffers may then be used by some other oper¬ 
ator display station, thus reducing the number of buffers that 
must be linked. 

Table E-10 shows the DEF-I fixed (F) and dynamic (D) buffer 
requirements for the DEF-I functions and indicates whether the 
buffers are temporarily held or are held as long as the function 
is being used. The figures given are for a single operator dis- * 
play station. 
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Table E-10. Fixed and Dynamic Buffer Requirements 



NB1 

1024 Wds 

NB2 

256 Wds 

NB3 

Configurable 

NB5** 

Function 

F 

F 

D 

F 

D 

10 Wds 

DATA ENTRY 

1* 

1 

1 

1 

1 

As many as 
needed 

DATA ENTRY WITH 
TABLES 

1* 

1 

1 

1 

1 

As many as 
needed 

DATA ENTRY WITH 
PROGRAMS 

1* 

1 

1 

1 

1 

As many as 
needed 

DATA ENTRY WITH 
TABLES/PROGRAMS 

1* 

1 

. 

1 

1 

1 

As many as 
needed 

DATA ENTRY - 
MODIFICATION 

1* 

1 

1 

1 

2 

As many as 
needed 

DATA 

VERIFICATION 

1* 

1 

1 

1 

2 

As many as 
needed 

FORMS CREATION 

1 

1 - 

- 

- 

FORMS MODIFY 

2 

1 

1 .. 

- 

- 

CREATE A VERIFY 
TABLE 

1 

- 

- 

- 

CREATE AN 

EXTRACT TABLE 

2 

- 

- - 

- 

COPY A FORM 

OR TABLE 

2 

1 - 

- - 

— 

VIEW A FORM 

OR VERIFICATION 
TABLE 

1 

1 - 



VIEW AN EXTRACT 
TABLE 

2 

i 

1 - 

- 

- 

FILE PRINTING 
(FORMATTED) 

1* 

1* - 

1* - 

As many as 
needed 

PRINT A FORM 

OR TABLE 

1 

1 - 

1 - 

— 

SHIFT F7 PRINT 

1* 

- 

- 

- 
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Table E-10 (cont) . Fixed and Dynamic Buffer Requirements 


♦Indicates that the buffers are used temporarily and then 
released. 


**NB5 buffers are used for extended field (program calls, 
upper/lower limits, tables, constants) used on the form. 
There is one NB5 required per extended field used on a 
form. 


I 


General rules based upon the above table for linking NB1, 
NB2, NB3, and NB5 size buffers are as follows: 

• For operator display stations used for data entry only 
use: 


NB 1 

per 

2 operator displc 

ly stations 

NB2 

per 

operator 

display 

station 

NB 3 

per 

operator 

display 

station 

NB 5 

per 

operator 

display 

station per 

form 





For operator display stations used for 


reat 

ion, 

tables, 

copies, ( 

etc.) : 

NB 1 

per 

operator 

display 

station 

NB2 

per 

operator 

display 

station 

NB 3 

per 

ope rator 

display 

station 

NB 5 

per 

operator 

display 

station 


form 


extended field on 

development (form 


extended field on 


NOTE: Attempts to process with insufficient buffers linked 

produce unspecified results. In most cases, an 
INSUFFICIENT USER MEMORY message will appear on line 
24 of the operator display station. 

The following directives define the number of buffers allo¬ 
cated for each size and the size of buffer 3. Buffer 3 is used 
for the Data Entry buffer and contains the current data entry 
record. Therefore, the specified size must be the same as the 
buffer size specified when linking any data entry programs. 

Also, the number of data characters the buffer will contain is 
twice the buffer size in words less 16 characters for the header. 
(See the DEF-I User's Guide.) 
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Directive 


Comment 


VDEF 

NB1,X'0004' 

/NUMBER 

OF 

SIZE 

1 

BUFFERS=4 

VDEF 

NB2,X'0004' 

/NUMBER 

OF 

SIZE 

2 

BUFFERS=4 

VDEF 

NB 3,X'0004' 

/NUMBER 

OF 

SIZE 

3 

BUFFERS=4 

VDEF 

NB4,X'0000' 

/NUMBER 

OF 

SIZE 

4 

BUFFERS=0 

VDEF 

NB5,X 1 0028' 

/NUMBER 

OF 

SIZE 

5 

BUFFERS=40 



(hexadecimal 28) 



VDEF 

SB3,X'0080 1 

/SIZE OF BUFFER3 


= 128 (Hex 80) 


words=256 characters 


* 

Data Entry Program General Purpose Buffer 


The following directive specifies the size of the general 
purpose buffer, buffer number 6, used by any data entry program. 
You must specify a buffer size as large as the largest general 
purpose buffer required by any data entry program that will 
execute on your system. The buffer size is specified in words, 
half the number of characters the buffer will hold. One buffer 
is used for each operator display station executing a data entry 
program. 


Directive 


Comment 


VDEF DUPWRD,X'0020' /SIZE OF DATA ENTRY PROGRAM 

/GENERAL PURPOSE BUFFER=32 
/(hex 20) WORDS =64 
/CHARACTERS 

First LFN 

The following directive defines the first LFN to be used 
by DEF-I. This number affects the value of the maximum LFN 
argument specified in the spawn group command for the task 
group. In the following example, LFNs 1 to 8 are available for 
use by data entry programs. Note, however, that the DEF-I LFNs 
may also start at 1. In that case, the program LFNs would start 
following the last DEF-I LFN. DEF-I requires 8 LFNs per operator 
display station and 8 LFNs per background area. 

VDEF CRTLFN,X'0009' /FIRST CRT LFN=9 
Number of Background Tasks 
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The following directive defines the number of background 
tasks to be run concurrently. It cannot exceed the number of 
CRT's nor can it exceed the total number of LRNs defined by the 
LOLRN and HILRN arguments. File printing and application pro¬ 
grams optionally run in the background. File print needs a back¬ 
ground task even when the print operation is not in the back¬ 
ground. At least one background task must be specified. 

VDEF BAKNO,X'0002 1 /NUMBER OF BACKGROUND TASKS=2 
Assigning Volume Name 


Each of the following four directives defines two characters 
of the name of the volume which DEF-I will initially use for 
forms, tables, and data entry. The hexadecimal values for the 
appropriate ASCII characters are specified. Only eight char¬ 
acters are allowed, the first must be circumflex (hexadecimal 
5E), the eighth must be hexadecimal 3E. Note that the volume as¬ 
signments can be changed by a DEF-I supervisory function, but 
this link specified volume name must be present when DEF-I is 
loaded. 


Directive 


Comment 


VDEF SVN1,X 1 5E44' 
VDEF SVN2,X'4546' 
VDEF SVN3,X'5752' 
VDEF SVN4,X'4B3E' 


/SYSTEM VOLUME 3 ~D 
/ =EF 

/ =WR 

/ =K> 


Specifying Password Parameters 


The following directives define the size and total number of 
passwords available and one initial password used to gain entry 
to DEF-I. Note that the initial password is specified using five 
directives, one for each two characters, even if the password is 
less than 10 characters long. The excess characters must be 
specified as blanks (hex 20). The directives are only required 
if the operator security feature is linked. The passwords may be 
maintained by the password update facility. 
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Directive 


Comment 


VDEF PASSNO,X'0010' /NUMBER OF PASSWORD AVAILABLE=16 

(hex 10) 

/MUST BE 0 IF NO OPERATOR SECURITY 

VDEF PASSIZ f X'0004' /LENGTH OF PASSWORD=4. MAXIMUM 

/SIZE IS 10 CHARACTERS 

VDEF PASS 1,X'4445' /INITIAL PASSWORD IS DEF3.2 

VDEF PASS2,X'463 3 1 /(HEX 44, 45, 46, 33, 2E, 32= ASCII 

DEF 3.2) 

VEDF PASS 3,X 1 2E 32 1 (HEX 2E,32=ASCI1.2) 

VDEF PASS4,X 1 2020 ' /(HEX 20=BLANK) 

VDEF PASS5,X'2020' 

Specifying Password Accessible Functions 

The following directive specifies the functions which may be 
accessed using the first password specified above. If any addi¬ 
tional passwords are required the initial password must be given 
access to the supervisor function. The functions available are 
specified by the first 9 bits of the 16 bit, 4 hex character 
argument. If the bit value for the associated function is zero, 
the function is not available; if the bit value is one, the 
function is available. Table E-ll lists the bits and their asso¬ 
ciated functions. Bit 0 is the high order bit. 

Table E-ll. Accessible Function Specification 


I 


Thus, a directive specifying that all functions are avail¬ 
able using the first password would be as follows. This direc¬ 
tive content is recommended. 


Bit 

Function 

0 

Applications 

1 

Data Entry 

2 

Forms 

3 

File Print 

4 

(Reserved) 

5 

Supervisor 

a 

\j 

Tables 

7 

Utilities 

8 

Verification 
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Directive 


Comment 


VDEF PASSFN,X'FFFF 1 /ALL FUNCTIONS ARE AVAILABLE 

Specifying Allowable Operator Functions 

The following directives determine which DEF-I functions can 
be selected by the operator display station users. If X'0000' is 
entered for any of these directives, the corresponding DEF-I 
function cannot be used by any data entry operator. If the 
function i^s to be allowed, the hexadecimal value of the appro¬ 
priate ASCII character must be specified, as illustrated in the 
example. 

Directive 

VDEF APPL,X'0041 1 
VDEF DATA,X'0044' 

VDEF FORM,X 1 0046' 

VDEF INTRA,X'0000 1 
VDEF FILPRN,X'0050 * 

VDEF SUPER,X'0053 1 
VDEF TABLE,X'0054' 

VDEF UTIL,X 1 0055' 

VDEF VERIF,X'0056' 

Printer Assignments 

The following directives determine the initial printer 
assignments for each CRT. All 20 assignments must be made, even 
though fewer than 20 CRT's are available. Printer assignments 
may be temporarily changed by a DEF-I Supervisory Function. 

Directive Comment 


VDEF 

PCRT1,X'0001' 

/CRT 

1 USES 

PRINTER 

1 

VDEF 

PCRT2,X'0001' 

/CRT 

2 USES 

PRINTER 

1 

VDEF 

PCRT 3,X'00 01 1 

/CRT 

3 USES 

PRINTER 

1 

VDEF 

PCRT4,X'0001' 

/CRT 

4 USES 

PRINTER 

1 

VDEF 

PCRT5,X'0001' 

/CRT 

5 USES 

PRINTER 

1 

VDEF 

PCRT6,X'0001' 

/CRT 

6 USES 

PRINTER 

1 

VDEF 

PCRT7,X'0001' 

/CRT 

7 USES 

PRINTER 

1 

VDEF 

PCRT8,X 1 0001' 

/CRT 

8 USES 

PRINTER 

1 

VDEF 

PCRT9,X'0001' 

/CRT 

9 USES 

PRINTER 

1 

VDEF 

PCRT10,X'0001' 

/CRT 

10 USES 

PRINTER 

1 

VDEF 

PCRT11,X'0001 * 

/CRT 

11 USES 

PRINTER 

1 

VDEF 

PCRT12,X'0001' 

/CRT 

12 USES 

PRINTER 

1 

VDEF 

PCRT13,X'00 01 1 

/CRT 

13 USES 

PRINTER 

1 

VDEF 

PCRT14,X'0001 ' 

/CRT 

14 USES 

PRINTER 

1 

VDEF 

PCRT15,X'00 01 ' 

/CRT 

15 USES 

PRINTER 

1 

VDEF 

PCRT16,X'0001' 

/CRT 

16 USES 

PRINTER 

1 

VDEF 

PCRT17,X'0001' 

/CRT 

17 USES 

PRINTER 

1 

VDEF 

PCRT18,X'0001' 

/CRT 

18 USES 

PRINTER 

1 


Comment 

/ALLOW APPLICATIONS=A 
/ALLOW DATA ENTRY=D 
/ALLOW FORM CREATE=F 
/RESERVED 

/ALLOW FILE PRINT=P 
/ALLOW SUPERVISOR FUNCTION=S 
/ALLOW TABLES CREATE=T 
/ALLOW UTILITIES=U 
/ALLOW VERIFICATIONS 
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Directive 


Comment 


VDEF PCRT19,X'0001' /CRT 19 USES PRINTER 1 

VDEF PCRT20,X'0001' /CRT 20 USES PRINTER 1 


Data Entry Overlay Areas 

The following directives define which of the data entry 
overlay areas is to be used by each operator display station for 
execution of overlayed data entry programs. The hexadecimal 
value is the number of the data entry overlay area to be used 
and must be in the range 0001 through 0004. 

As with the printer assignments, the data entry overlay 
area assignments must be made for 20 CRT's, even though fewer are 
available. Note that these overlays are different from the DEF-I 
function overlay area. 

Directive Comment 


VDEF 

OC RT1, X ' 0 0 01 ' 

/CRT 

1 

USES 

OVERLAY 1 

VDEF 

OCRT2,X'0001' 

/CRT 

2 

USES 

OVERLAY 1 

VDEF 

OC RT 3,X'0 0 01' 

/CRT 

3 

USES 

OVERLAY 1 

VDEF 

OCRT4,X'0001' 

/CRT 

4 

USES 

OVERLAY 1 

VDEF 

OCRT5,X'0001' 

/CRT 

5 

USES 

OVERLAY 1 

VDEF 

OCRT6,X'0001' 

/CRT 

6 

USES 

OVERLAY 1 

VDEF 

OCRT7,X'0001' 

/CRT 

7 

USES 

OVERLAY 1 

VDEF 

OCRT8,X'0001' 

/CRT 

8 

USES 

OVERLAY 1 

VDEF 

OCRT9,X'0001' 

/CRT 

9 

USES 

OVERLAY 1 

VDEF 

OCRT10,X'0001' 

/CRT 

10 

USES 

OVERLAY 1 

VDEF 

OCRT11,X'0001' 

/CRT 

11 

USES 

OVERLAY 1 

VDEF 

OCRT12,X'0001 ' 

/CRT 

12 

USES 

OVERLAY 1 

VDEF 

OCRT13,X 1 0001' 

/CRT 

13 

USES 

OVERLAY 1 

VDEF 

OCRT14,X'0001 ' 

/CRT 

14 

USES 

OVERLAY 1 

VDEF 

OCRT15,X 1 0001' 

/CRT 

15 

USES 

OVERLAY 1 

VDEF 

OCRT16,X'0001 ' 

/CRT 

16 

USES 

OVERLAY 1 

VDEF 

OCRT17,X'0001' 

/CRT 

17 

USES 

OVERLAY 1 

VDEF 

OCRT18,X'0001 ' 

/CRT 

18 

USES 

OVERLAY 1 

VDEF 

OCRT19,X 1 0001' 

/CRT 

19 

USES 

OVERLAY 1 

VDEF 

OCRT20,X'0001 ' 

/CRT 

20 

USES 

OVERLAY 1 


Completing the Link 

The link must be completed with the QUIT directive. The 
MAP directive is optional. 

MAP 

QUIT 

GROUP GENERATION FOR A DEF-I SYSTEM 

Use the SG (spawn group) command to spawn a task group in 
which DEF-I can operate. A complete description of the SG com¬ 
mand appears in the Commands manual. 
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Task Group Considerations 


The task group in which DEF-I is to execute requires the 
following specifications for the maximum LRN and LFN: 

LRN - the value must be greater than the maximum LRN used in 
the START_UP.EC file's CT (create task) commands. 

LFN - the value must be equal to or greater than the result 
of the following algorithm: 

base LFN specified in the Linker VDEF CRTLFN directive 
+ 8 x (number of CRT's) 

+ 8 x (number of background tasks allowed at one time) 

+ 1 if operator statistics are required 

+ the number of LFNs required by data entry programs and 
applications. 

Example of a Spawn Group Command 

For example, a typical DEF-I SG (spawn group) command might 
be as follows: 

SG AA D.E.F. 0 1C0NS0LE -LRN 28 -LFN 58 -POOL AB -WD DEFDIR 
SG 

The spawn group command 
AA 

The id assigned to this task group 

D.E.F. 

The user_id assigned 

0 

Relative priority level for this task group's lead 
task 

!CONSOLE 

Input path for commands and user input 
-LRN 28 

Highest logical resource number that will be referred 
to by any task in the task group 
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-LFN 58 


Highest logical file number used by any task in the 
spawned task group 

-POOL AB 

Name of the memory pool from which all dynamic memory 
required by the task group is to be taken 

-WD DEFDIR 

The working directory to be used by the task group. 

The directory used should have a START_UP.EC file 
containing the CT (create task) command to activate 
DEF-I. 

The LRN in the example is greater than the maximum LRN used 
in the START_UP.EC file's CT (create task) command below. 

The LFN value of 58 is greater than the value determined by 
the following calculation: 

LFN = 8x4 (terminals) + 8x2 (background tasks) + 9 (base 
LFN, specified in Linker VDEF CRTLFN directive) = 57 

DEF START-UP.EC FILE (TASK GENERATION). 

Once the SG (spawn group) command has been executed, several 
DEF-I tasks must be created and activated. Appropriate CT (cre¬ 
ate task) commands may be stored in a START_UP.EC file immedi¬ 
ately subordinate to the inital workng directory of the spawned 
task group or they may be specified individually at initializa¬ 
tion time. START_UP.EC files are discussed in the System 
Concepts manual. 

Create Task 


Tasks are created by CT (create task) commands as follows: 
CT lrn rel_level ctl_arg 

lrn is the logical resource number by which the task 
group refers to the task 

rel_level is the priority level of the task 
ctl_arg is either the control argument 
-EFN root?symbolic-start-address 
or 

-SHARE lrn symbolic-start-address 
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where the -EFN argument includes the name of the 
bound unit root segment (here DEF-I) followed by 
a question mark, followed by the symbolic-start- 
address (entry point) within the root segment, 
DEF initialization (INFNTR). 

The -SHARE control arguments specify the addi¬ 
tional entry points within the DEF bound unit, 
and the LRN used is that associated with the 
initialization (INFNTR) entry point. 

RELATIVE LEVEL REQUIREMENTS 

The CT (create task) command priority level requirements for 
DEF-I tasks are shown in Table E-12. 


Table E-12. DEF-I Relative Priority Level Requirements 


Relative 

Level 

Symbolic-Start-Address 

Description 

1 

DSHTAS 

DEF Disk Handler 

2 

DBENT 

DEF Buffer Manager 

3 

LOCKOl 

DEF File Lock Routine 

5 

INFNTR 

DEF Initialization/CRT #1 



Control 

6-n 

CENTRY 

DEF CRT #2 (and up) Control 

n+1 1 

(none) 

DEF Background Functions 

n+m+1 1 

C0BMR1 if memory resident 

Optional for Data Entry 


C0B0V1 is overlay area 1 

Programs 


COBOV2 is overlay area 2 



C0B0V3 is overlay area 3 



C0B0V4 is overlay area 4 



In this example CENTRY, background tasks, and data entry 
programs are not given relative level values because one CT 
(create task) command is required per CRT, background task, and 
bound unit for data entry programs. Note that a maximum of four 
overlay areas and one memory resident bound unit for data entry 
programs may be specified. Note also that these are minimum 
relative level requirements within DEF-I and do not reflect any 
other LRNs within the task group. 


i n - Last relative level used for a CRT 
m - Number of background tasks created. 
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Sample START-UP.EC File 


The commands listed in Figure E-3 are typical for a DEF-I 
START UP.EC file. The filename is ~ZSYS71>DEFDIR>START UP.EC. 


CRD >DEFDIR 

CT 5 5 -EFN JbFVINFNTR 
CT I I -SHAte b DSH'l'AS 
CT 2 2 -SHARc 5 DbfcNT 
CT 3 3 -SHAFfc b LOCKOI 
CT 6 6 -SHAft: 5 CENTRY 
CT 7 7 -SHARc b CENTRV 
CT a b -SHARE b CENTRY 
CT 25 2b -SHARE 5 
CT 26 26 -SHARE 5 
CT 27 27 -EFW' ENTRY I 7COBOVI 
RDN 
ETR 5 

Figure E-3. Sample DEF-I START_UP.EC File 
In this example, DEF-I has the following: 

• 4 CRT’s 

• 2 background (file print/application) tasks. 

• 1 data entry program overlay area named ENTRY1 

The name of the DEF-I bound unit is DEF. 


SAMPLE SYSTEM FILE STRUCTURE 


Figure E-4 illustrates the path structure of the DEF-I 
related system files, as they are supplied on the release media 
(the directory root name "ZSYS71 indicates a mass storage unit). 
Included are the sample CLM_USER file, CLM__SAMPLE, the sample 
DEF-I linker directive file DEF_SAMPLE.S, IEF_SAMPLE.S, and all 
DEF-I required object units. 

Figure E-5 illustrates a typical path structure of DEF-I 
related system files once the DEF-I system has been built. The 
following files have been added to those shown in Figure E-4. 

• The CLM_USER file (for example, the file in Figure E-l). 
This is placed in the directory SID. 

« The DEF-I spawn group command contained in an EC file. 

The file is illustrated in Figure E-6. Note that this is 
directly under the system root. 

• The DEF-I linker directives used to create the bound unit 
called DEF_USER.S. This file is under the directory 

Z DRT. 

• The DEF-I bound unit called DEF. 
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• The START_UP.EC that creates the DEF-I tasks is in the 
DEFDIR directory. An example of the startup file is 
illustrated in Figure E-3. 

• The bound units for the DEF-I data entry programs. 

The user-created DEF-I and data entry program bound units 
and the user-created DEF START_UP.EC are in a user-created direc¬ 
tory DEFDIR. 

Note that this set of files, naming conventions, and file 
paths is used as an illustration only. 


'ZSYS71 



Figure E-4. Paths of System Files 


E-31 


CB23-03 



ZSYS71 



a User-created CLM 

^User-created LINKER directives for DEF bound unit 
C DEF bound unit 

^EC file that spawns DEF group in working directory DEFDIR 

e START—UP.EC file that creates DEF tasks and issues group ready-on message 

f User-created data entry program (see the Data Entry Facility User's Guide.) 


Figure E-5. 


Sample Disk Organization of System and 
User DEF-I Files 


/?■ \ 

V,. - 
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& p ********************************* 

&P * bAMPLfc. 0 z P GwOUi”' Gt-'JtPtt I iiii'j * 

& P ********************************* 

SG AA D.E.F. ij > iPL>>Cl' JiUll: -1>N d6 bo -PljuL Ah -sMj * 

8rU 

Figure E-6 Sample DEF-I SPAWN GROUP EC File 
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Operator Startup Actions 


After all the preparatory procedures described in this 
section are completed and checked out, a DEF-I system can be 
started up by following a two-step procedure. Before presenting 
the procedure, the files that are required to be on disk are 
described: 


• A CLM_USER file specific to DEF-I under the directory SID 

• Bound units for the DEF-I system and user data entry 
programs. In the sample disk organization in Figure E-5, 
they are named DEF and ENTRY1. 

• A START_UP.EC file in the working directory to create 
DEF-I tasks and start executing at the proper entry 
point. In Figure E-5, the file START_UP.EC is in sample 
working directory DEFDIR. 

• An EC file to spawn a group for DEF-I, for example, 

DEF.EC in Figure E-5. 


The operator actions are then: 

1. Bootstrap the system software 

2. Enter the following command at the operator terminal: 


EC DEF 


A task group is created and the command processor 
loaded. The START_UP.EC files are then executed. They 
create and load the tasks of the DEF-I system, and then 
start execution of the initial DEF-I task, DEF7INFNTR, 
in the sample START_UP.EC file in Figure E-3. 


SAMPLE LINKER DIRECTIVE FILES 


Figure E-7 is a listing with supplied sample argument 
values, of all the Linker directives required to link a DEF-I 
system. 
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/ LINKER COMMANDS FOR DEF 
LIB >ZDRT / 

LINKN ZDFCTL / 

LINKN ZDFIAD / 

LINKN ZDFLTD / 

LINKN ZDFQSR / 

LINKN ZDFBGR / 

LINKN ZDFSTA / 

/ / 

OVLY APOLAY / 

BASE S / 

LINKN ZDFAP / 

PROT AP8ASE,APEND / 

OVLY DEOLAY / 

BASE APEND+X'1' / 

LINKN ZDFDE1 / 

PROT DEBASE,DEEND / 

OVLY FMOLAY / 

BASE APEND+X'1' / 

LINKN ZDFFM1 / 

PROT FMBASE,FMEND / 

OVLY FPOLAY / 

BASE APEND+X'I ' / 

LINKN ZDFFP / 

PROT FPBASE,FPEND / 

OVLY SPOLAY / 

BASE APEND + X'1 * / 


LINKN ZDFSP1,ZDFPUP,ZDFSP2 
PROT SPBASE,SPEND / 

OVLY TBOLAY / 

BASE APEND + X ' 1 # / 

LINKN ZDFTB / 

PROT TB8ASE,TBEND / 

OVLY OTOLAY / 

BASE APEND+X'1' / 

LINKN ZDFUT / 

PROT UT8ASE,UTEND / 

OVLY VEOLAY / 

BASE DEEND+X'BO' / 

LINKN ZDFVE / 

PROT VEBASE,VEEND / 

/*********,*,**,*,*,**,,*, 
/ 

VDEF DKLRN,X'0100' 

VDEF 8MLRN,X'0200' 

VDEF LOKLRN,X'0300' 

VDEF INILRN,X'0500' 

VDEF LOLRN,X # 0019' 

VDEF HILRN,X'001A' 

VDEF CRLRN1,X'OOOO' 

VDEF OVLRN1,X'1BOO' 

VDEF 0VLRN2,X'0000' 

VDEF OVLRN3,X'0000' 

VDEF 0VLRN4,X'0000' 

/ 

VDEF QLYNQ,X'8 # 


3.2 (FOR NON-RESIDENT SYSTEM) 

LIBRARY OF OBJECT MODULES 
DEF SYSTEM ROUTINES 
REQUIRED FOR DEF SYSTEM 
REQUIRED FOR DEF SYSTEM 
OPERATOR SECURITY 
BACKGROUND CONTROL 
OPERATOR STATISTICS 
DEF FUNCTION OVERLAYS 
APPLICATIONS OVERLAY 
STARTS AFTER END OF ROOT 
LINK APPLICATIONS 
PROTECT START/END ADDRESS 
OVERLAY DATA ENTRY 
START AFTER END OF APPLICATIONS 
LINK DATA ENTRY 
PROTECT START/END ADDRESS 
FORMS PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK FORMS PROCESSOR 
PROTECT START/END ADDRESS 
FILE PRINT PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK FILE PRINT PROCESSOR 
PROTECT START/END ADDRESS 
SUPERVISOR FUNCTIONS OVERLAY 
STARTS AFTER END OF APPLICATIONS 
/ LINK SUPERVI8QR/PWRD UPDATE 
PROTECT START/END ADDRESS 
TABLES PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK TABLES PROCESSOR 
PROTECT START/END ADDRESS 
UTILITIES PROCESSOR OVERLAY 
STARTS AFTER END OF APPLICATIONS 
LINK UTILITIES PROCESSOR 
PROTECT START/END ADDRESS 
VERIFICATION PROCESSOR OVERLAY 
STARTS AFTER DATA ENTRY 
LINK VERIFICATION PROCESSOR 
PROTECT START/END ADDRESS 
************************************* 

/ DEF SYSTEM LRNS 
/ LRN OF DISK HANDLER 
/ LRN OF BUFFER MANAGER 
/ LRN OF FILE LOCKER 

/ LRN OF CRT 1 (INITIALIZATION LEVEL) 

/ LOW LRN AVAIL FOR IEF /BACKGROUND 
/ HIGH LRN AVAIL FOR IEF/BACKGROUND 
/ LRN OF D.E. MEM. RESIDENT PROGRAM DIRECTOR 
/ LRN OF D.E. OVERLAY DIRECTOR 1 

/ LRN OF D.E. OVERLAY DIRECTOR 2 

/ LRN OF D.E. OVERLAY DIRECTOR 3 

/ LRN OF D.E. OVERLAY DIRECTOR a 

/ NUMBER OF FUNCTIONS U.w'.wAYEP 


Figure E-7. Sample DEF-I Linker Directive File 
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VDEF CRTC,X'0050' 
VDEF CRTL,X'0017' 
VDEF NCQNKN,X'0' 


/ COLS PER CRT LINE 
/ LINES PER CRT PAGE 

/ 0 = CONTINUOUS, NON 0 = NON CONTINUOUS KEY IN 


CRTLRN,X'OCOO' 
PRTLRN,X'0800' 
0PC0NS,X'59' 
CRTNO,X'0004' 
PRTNO,X'OOOl' 


VDEF AUTCAL,X'0000 
/ 

VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
/ 

VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
/ 


PRTCl, 
PRTL1, 
PRTC2, 
PRTL2, 
PRTC3, 
PRTL3, 
PRTC4, 
PRTL4, 
PRTC5, 
PRTL5, 
PRTC6, 
PRTL6, 
PRTC7, 
PRTL7, 
PRTC8, 
PRTL8, 


X'0088' 
X'003E' 
X'0 088' 
X'003E' 
X'0088' 
X'003E' 
X'0088' 
X'OOiE' 
X'0088' 
X'003E' 
X'0088' 
X'003E' 
X'0088' 
X'003E' 
X'0088' 
X'003E' 


NB1,X'0004' 
N82,X'0004 ' 
S83,X'0080' 
NB3,X'0004' 
NB4,X'0000' 
NB5,X'0028' 
DUPWRD,X'0020 


VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
VDEF 
/ 

VDEF 
VDEF 
/ 

VDEF SVN1,X'5E44' 
VDEF SVN2,X'4546' 
VDEF SVN3,X'5752' 
VDEF SVN4,X'4B3E' 
/ 


CRTLFN,X'0009' 
BAKNO,X'0002' 


VDEF PASSNO, 
VDEF PASSIZ, 
VDEF PASS 1,X 
VDEF PASS2/X 


X'0010' 

X'0006‘ 

'4445' 

'4633' 


VDEF PASS3,X'2E32' 
VDEF PASS4,X'2020' 
VDEF PASS5,X'2020' 


RESERVED 

REFERENCES TO LRN'S IN CLM..USER 
LRN OF CRT 1 DRIVER 
LRN OF PRINTER 1 DRIVER 
/ 59 s OP. CONSOLE, 4E = NO OP. CONSOLE 
/ TOTAL NUMBER OF CRTS 

NUMBER OF PRINTERS CONFIGURED 
PARAMETERS TO DEFINE PRINTERS 


/ 

/ 

/ PRINTER 1 LINE WIDTH 
/ PRINTER 1 LINES PER PAGE 
/ PRINTER 2 LINE WIDTH 
/ PRINTER 2 LINES PER PAGE 
/ PRINTER 3 LINE WIDTH 
/ PRINTER 3 LINE'S PER PAGE 
/ PRINTER 4 LINE WIDTH 
/ PRINTER 4 LINES PER PAGE 
/ PRINTER 5 LINE WIDTH 
/ PRINTER 5 LINES PER PAGE 
/ PRINTER 6 LINE WIDTH 
/ PRINTER 6 LINES PER PAGE 
/ PRINTER 7 LINE WIDTH 
/ PRINTER 7 LINES PER PAGE 
/ PRINTER 8 LINE WIDTH 
/ PRINTER 8 LINES PER PAGE 
/ BUFFER ALLOCATIONS 
/ NO. OF SIZE 1 BUFFERS 
/ NO. OF SIZE 2 BUFFERS 
/ SIZE OF DATA ENTRY BUFFER 
/ NO. OF SIZE 3 BUFFERS 
/ NO. OF SIZE 4 BUFFERS 
/ NO. OF SIZE 5 BUFFERS 
/ SIZE OF GENERAL PURPOSE BUFFER 

/ FIRST LFN AVAILABLE TO DEF 
/ NUMBER OF BACKGROUND TASKS 
/ DEF SYSTEM VOLUME NAME 

/ SYSTEM VOLUME IS J- 'D 

/ EF 

/ WR 

/ K> 

/ PARAMETERS TO DEFINE SYSTEM PASSWORDS 
/ NO. OF PASSWORDS (=0 IF NO OPERATOR SECURITY) 
/ LENGTH OF PASSWORD 
/ INITIAL PASSWORD = DEF3.2 


VDEF PASSFNf X # FFFF # 

/ FUNCTIONS FOR 

INITIAL 

PASSWORD 


/ 

BIT 0 = AP, 

BIT 1 = 

DE, BIT 2 = 

FM, 

/ 

BIT 3 = FP, 

BIT 4 = 

(RESERVED), 

BIT 5 = 3P , 

/ 

BIT 6 = TB, 

BIT 7 = 

UT, BIT 8 = 

VE 

/ 

/ FUNCTION LIST 

(0 = NOT 

CONFIGURED) 



Figure E-7 (cont). Sample DEF-I Linker Directive File 
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VDEF APPL,X'4l' 

VDEF DATA* X'44' 

VDEF FORM,X'46' 

VDEF INTRA,X'00' 
VDEF FILPRN,X'50' 
VDEF SUPER*X'53' 
VDEF_TABLE*X'54' 
VDEF UTIL,X'55' 

VDEF VERIF* X'56' 

/ 

VDEF PCRT 1 * X'0001 ' 
VDEF PCRT2* X 'OOO1 ' 
VDEF PCRT3* X '000 1 ' 
VDEF PCRT4,X'0001' 
VDEF PCRT5,X'0001' 
VOEF PCRT6*X'0001' 
VDEF PCRT7*X'0001 ' 
VDEF PCRT8,X'0001' 
VDEF PCRT9* X'0001 ' 
VDEF PCRT10,X'0001' 
VDEF PCRT11 * X '0001 ' 
VDEF PCRT12*X'0001' 
VDEF PCRT13*X'0001' 
VDEF PCRT14,X'0001' 
VDEF PCRT15*X'0001' 
VDEF PCRT16* X'OOOl' 
VDEF PCRT17*X'0001' 
VDEF PCRT18* X'000 1 ' 
VDEF PCRT19,X'OOOl' 
VDEF PCRT20*X'0001' 
/ 

VDEF QCRT1 * X'0001' 
VDEF 0CRT2* X'0001 ' 
VDEF OCRT3*X'0001' 
VDEF 0CRT4,X'OOOl' 
VDEF 0CRT5* X'OOOl' 
VDEF 0CRT6* X'0001 ' 
VDEF QCRT7,X'OOOl' 
VDEF QCRT8*X'0001' 
VDEF QCRT9,X'0001' 
VDEF OCRT10,X'0001' 
VDEF OCRT11*X'0001 # 
VDEF OCRT12,X'0001' 
VDEF UCRT13,X'0001' 
VDEF OCRT14,X'0001 ' 
VDEF UCRT15,X'0001" 
VDEF OCRT16,X'0001' 
VDEF QCRT17*X'0001' 
VDEF QCRT18,X'0001' 
VDEF OCRT19*X'0001' 
VDEF OCRT20,X'0001' 
MAP 
QUIT 


/ APPLICATIONS 
/ DATA ENTRY 
/ FORM CREATION 
/ RESERVED 
/ FILE PRINT 
/ SUPERVISOR 
/ TABLES 
/ UTILITIES 
/ VERIFICATION 

/ PRINTER ASSIGNMENTS FOR EACH CRT 
/ PRINTER ASSIGNMENT FOR CRT 1 
/ PRINTER ASSIGNMENT FOR CRT 2 
/ PRINTER ASSIGNMENT FOR CRT 3 
/ PRINTER ASSIGNMENT FOR CRT 4 
/ PRINTER ASSIGNMENT FOR CRT 5 
/ PRINTER ASSIGNMENT FOR CRT 6 
/ PRINTER ASSIGNMENT FOR CRT 7 
/ PRINTER ASSIGNMENT FOR CRT 8 
/ PRINTER ASSIGNMENT FOR CRT 9 
/ PRINTER ASSIGNMENT FOR CRT 10 
/ PRINTER ASSIGNMENT FOR CRT 11 
/ PRINTER ASSIGNMENT FUR CRT 12 
/ PRINTER ASSIGNMENT FOR CRT 13 
/ PRINTER ASSIGNMENT FOR CRT 14 
/ PRINTER ASSIGNMENT FOR CRT 15 
/ PRINTER ASSIGNMENT FOR CRT 16 
/ PRINTER ASSIGNMENT FUR CRT 17 
/ PRINTER ASSIGNMENT FOR CRT 18 
/ PRINTER ASSIGNMENT FOR CRT 19 
/ PRINTER ASSIGNMENT FOR CRT 20 
/ OVERLAY DIRECTOR ASSIGNMENT PER CRT 
/ OVERLAY AREA FOR CRT 1 
/ OVERLAY AREA FOR CRT 2 
/ OVERLAY AREA FOR CRT 3 
/ OVERLAY AREA FOR CRT 4 
/ OVERLAY AREA FOR CRT 5 
/ OVERLAY AREA FOR CRT 6 
/ OVERLAY AREA FOR CRT 7 
/ OVERLAY AREA FOR CRT 8 
/ OVERLAY AREA FOR CRT 9 
/ OVERLAY AREA FOR CRT 10 
/ OVERLAY AREA FOR CRT 11 
/ OVERLAY AREA FOR CRT 12 
/ OVERLAY AREA FOR CRT 13 
/ OVERLAY AREA FOR CRT 14 
/ OVERLAY AREA FOR CRT 15 
/ OVERLAY AREA FOR CRT 16 
/ OVERLAY AREA FOR CRT 17 
/ OVERLAY AREA FOR CRT 18 
/ OVERLAY AREA FOR CRT 19 
/ OVERLAY AREA FOR CRT 20 



Figure E-7 (cont). Sample DEF-I Linker Directive File 
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V. 




APPENDIX F 


REMOTE BATCH FACILITY/66 


CONFIGURATION 


After the GCOS 6 MOD 400 software has been initially loaded 
by a stage 1 system startup, you must define a file of input 
directives, called the CLM_USER file, for the Configuration Load 
Manager (CLM). This file will contain the device symbolic names, 
communications arguments, and memory pool assignments necessary 
to use GCOS 6 MOD 400 software on your hardware system. 

Any future changes to the Remote Batch Facility configura¬ 
tion are made by editing the CLM_USER directive file to reflect 
these changes. 

Configuration Directives 

To create a Remote Batch Facility with Remote Computer 
Interface (RCI), you must specialize your GCOS 6 MOD 400 system 
software by providing the necessary configuration directives. * 

NOTE: Only information specifically required to create 

an RCI Remote Batch Facility is provided. Full * 

descriptions of configuration directives are given 
in previous sections of this manual. 

DIRECTIVES APPLICABLE TO RCI * 

SYS 60,100,,10,tsa , irb 

The olan argument must be > 2 . 

Suggested values for tsa: 

30 for RCI 

Suggested values for irb: * 


60 for RCI 
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COMM 8 


This directive is used in the normal manner; i.e., it 
must precede the LPHn directives and specify the com¬ 
munications interrupt level. Both the communications 
interrupt level and the normal mode level should be 
the highest priority hardware levels in the system to 
ensure satisfactory operation. 

Recommended levels are 7 or 8 in the COMM directive 
and 8 or 9 in the second argument of all LPHn direc¬ 
tives (see below). 

ACU lrn ,level,X'acu_channel' [ ,'phone_#1] [,'phone_# 2'] [,...] 

This directive is used in the normal manner to con¬ 
figure the optional Auto Call Unit for automatic 
dialing. See Section 6. 

MEMPOOL S,,size 

The Remote Batch Facility requires a system memory 
pool size of 9200 words. 

For example, if your configuration requires 5500 
words for system functions and 9200 words for the 
Remote Batch Facility, you would specify: 

MEMPOOL S,,14700 

LDBU ZERRST 

You must include this directive in your CLM file if you wish 
to collect peripheral device or memory error statistics. 

Error logging configuration is fully described elsewhere in 
this manual. Error logging procedures are described in the 
Operator's Guide . 
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Example of Remote Batch Configuration Directives 


a 


The following directives give configuration 
Remote Batch Facility having four RCI streams. 


information for 


MEMPOOL S,,16000 
MEMPOOL , AB,* 

COMM 8 

RCI 32,10,X'FC00 1 

DEVICE RCI00,32,10 ,X'FC00' ,LINE32 
RCI 33,10,X'FC80' 

DEVICE RCI01,33,10,X'FC80' ,LINE33 
LDBU ZERRST 


QUIT 

NOTE: The bound unit ZQRCI must reside in directory SID 

of the root directory. The LDBU ZERRST directive 
allows the user to configure error logging, as 
described in Appendix P. Using this CLM file, the 
user may designate his host link by one of the 
following: RBT 32 

RBT !LINE 32 
RBT >SPD>LINE32 


INITIALIZATION 


Once configuration is complete, you can execute an RBT in 
the task group $H or create your own task group. If multiple 
terminals are used, there must be a task group for each terminal. 
The different methods that can be used to create a task group 
are described below. Whether you use $H or create your own 
group, you must also assign devices/files, modify external 
switches if necessary, and invoke the task group. 

Using the $H Task Group 

To use the Honeywell-supplied $H task group, enter: 

EC GROUP$H(C/R) 

The command file creates the task group. 
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Initializing with the Spawn Group Command 


Use the spawn group (SG) command to create your own task 
group in which the remote batch terminal can operate. A complete 
description of the SG command can be found in the Commands 
manual. 

The following is an example of the SG command used to create 
an RBT task group: 

SG A1 SMITH.RBT.OPR 2 !CONSOLE -OUT iCONSOLE -POOL AB 
-WD RBT DIR -LRN 2 


SG 


The spawn group command. 


A1 


The id assigned to this task group. 
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SMITH.RBT.OPR 


The user id assigned 


2 


Relative priority level for this task group; each RBT 
task group you spawn must be assigned a unique 
priority level. 

!CONSOLE 

Input path for commands and user input. 

-OUT iCONSOLE 

File that is to receive user output and error output. 
-POOL AB 

Name of the memory pool from which all dynamic memory 
required by the task group is to be taken. 

-WD RBT_DIR 

The working directory to be used by the task group. 
The directory used should have a START_UP.EC file 
containing the ready on (RDN) command. This com¬ 
mand causes the system to issue a ready message 
when the task group has been created. 


-LRN 2 


Two logical resource numbers (LRN) are needed by RBT. 
This number should increase if there are any other 
requirements for this task group. 

MAKING INITIAL DEVICE ASSIGNMENTS 

Once the task group has been created, the input and output 
files are assigned to devices by using the ASSOCIATE command. 

The format for the command is: 

ASSOC lfn path_name (C/R) 

lfn is: 

1 - input file 

2 - print file 

3 - punch file 

The following is an example of the typeins: 

ASSOC 1 ICDROO 
ASSOC 2 !LPT00 

ASSOC 3 !MT900>vol>file 


F-5 


CB23-03 



The first line assigns the input file to card reader CDROO. The 
second line assigns the print file to line printer LPTOO. The 
third line assigns the punch file to magnetic tape unit MT900. 
Vol and file must be given names by which they can be accessed. 

MODIFYING EXTERNAL SWITCHES 


The External Switch Word (ESW) should be set, if desired. 
The ESW should first be set to all zeros and then the desired 
bits turned on. The format for the typein is: 


MSW -ALL 
MSW - 
-ALL OFF - 
-ON - 
n - 


OFF -ON nn...n(C/R) 

Command to modify ESW 

Turn off all ESW bits 

Turn on the following bits 

The bit (hexadecimal digit) 
to be turned on 


that is 


The following is a breakdown of the 
bits in the External Switch Word: 

Bit On Off 

0 LIST NOLIST 

1 PUNCH NOPUNCH 

2 AUTOCALL NOAUTOCALL 

3 Reserved for system use 

4 STATS NOSTATS 

5 ASCII (READ) GBCD 

6 Reserved for system use 

8 LFN 3 out ASCII LFN 3 out VBT 

9 \ 

A I 

B ! 

C ) Reserved for system use 
D \ 

E ) 

Default values can be used for ESW settings; bits 0 and 1 
will be set for LIST and PUNCH. The relationship between ESW 
settings and remote batch disposition codes is explained in the 
Remote Batch Facility User's Guide . 
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INVOKING THE RBT TASK GROUP 


To invoke the RBT task group and associate it with a logical 
stream, enter the following command: 

RBF lrn(C/R) (Cartridge disk environment) 

or 

~ZSYS11 RBF lrn(C/R) (Diskette environment) 

or 

RBT device_name 

The lrn value or device name is taken from the configuration 
directive in the CLM_USER file. It specifies the logical stream 
you wish to use. 

The system responds with: 

(tg) hhmm RBF xnnn mm/dd/hhmm AA/BB/CC/DDDD 

(tg) hhmm RBF RDY 

(tg) hhmm RBF STATION NAME = 9999 

tg - Task group id 
hhmm - Hours, minutes 

x - S for SAF mode, L for LAF mode 
nnn - Software revision number 
AA/BB/CC/DDDD - Date/Time identification of RBF 
9999 - NPS Station Name for LHDLC only. 

The system is now ready to accept commands. 

Initializing with a Command File 

An alternate method of performing initialization is to build 
a command file with the system Editor and use the EC command for 
execution. The following steps are necessary: 

1. Refer to the System Messages manual for a description of 
the execution command (EC) and the EC command arguments, 
and to the Program Preparation manual for instructions 
on the use of the Editor. 

An example of a command file to spawn a task group is: 

$ SP_GRP.EC 1980/06/08 

&N 

SG A1 RBT.USER.OPR 2 ICONSOLE -OUT !CONSOLE 
-WD RBF DIR -POOL AB 
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&Q 

To execute this command, you must be operating in the 
system task group (&S) and type in: 

EC SP_GRP (C/R) 

The system responds with: 

($S)SG A1 RBT.USER.OPR ... 

($S)RDY: 

You can now either remain in the system default task 
group or change to a new task group by typing: 

C :A1:(C/R) 

Again, it is advisable to turn ready on by typing: 

RDN(C/R) 

The task group responds with: 

(Al)RDY: 

2. The second command file, as stated above, performs the 
ASSOC and MSW commands and invokes the RBT. An example 
of this command file is: 

& RBT.EC 1980/06/08 

&N 

ASSOC 1 !CDR00 

ASSOC 2 !LPT00 

ASSOC 3 PUNCH_FILE 

MSW -ALL OFF -ON 01 (Optional; defines default state) 

RBT 03 (Cartridge disk; specify ~ZSYS11 RBT 03 for 
diskette) 

&Q 

The typein for this file is: 

EC RBT(C/R) 

The system responds by printing out the commands in the 
command file, and: 
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(tg) hhmm RBT xnnn mm/dd/hhimn 
(tg) hhmm RBT RDY: 

You are now ready to perform remote batch processing. 

If the system is to have multiple terminals, individual 
command files can be generated for the task groups and 
they can be-grouped into a single command file. 

Example: 

& SP_GRPS.EC 
&N 

EC SPJ3RP1 
EC SP_GRP2 
EC SP_GRP3 
ScQ 

By typing in: 

EC SP_GRPS(C/R) 

you can spawn three task groups with a single command, 
or, if desired, you can spawn the task groups 
individually. 
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APPENDIX G 


FILE TRANSMISSION 


This appendix describes the Level 6 configuration particu¬ 
lars that relate to file transmission in conjunction with the 
configuration information already presented in this manual. In 
this appendix, "TRAN" is a general term used to denote the 
various Level 6 file transmission utility designations (TRAN 
and TRANB). 

LINE PROTOCOL CONFIGURATION 

The VIP 7700 line protocol is utilized in file transmission 
between the Level 6 and Honeywell host systems. Through the use 
of the PVE (polled VIP Emulator) line protocol handler, the 
Level 6 appears to the host system as a VIP 7700 terminal. The 
PVE is configured using the PVE directive as described in 
Section 6 of this manual. 

The following argument specifications of the PVE directive 
must be noted in configuring a Level 6 for file transmission: 

• The poll address specified in the directive must match 
that configured in the host system for the desired 
communications line. 

• High-speed lines should be configured at the highest 
priority levels (lowest numeric); i.e., line speeds of 
2400 and 9600 baud could be configured at priority 
levels of 20 and 10, respectively, but not 10 and 20. 

The maximum line speed supported in the'file transmission 
facility is 9600 baud. 

• The disk device containing the files to be transmitted 
or received must be configured at a lower priority level 
(higher numeric) than the communications device. 
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• The lrn selected for the directive is the argument used 
in the TRAN invocation for file transmission (see the 
appropriate File Transmission manual). If a DEVICE 
directive is coupled with a PVE directive, a filename may 
be used in the TRAN invocation as an alternative to a 
numeric lrn. 

In a Level 6 to Level 6 file transmission configuration, the 
Level 6 designated as the host system (acceptor) is configured 
with a VIP (see Section 6) for the communications line, while the 
Level 6 acting as the remote station (initiator) is configured 
with a PVE for the same line. Again, the poll addresses must 
match. 

NOTE: If nonswitched lines are used in Level 6 to Level 6 

file transmission, the system configured with a PVE 
must have TRAN invoked first. This will insure that 
polls sent from the host system will be answered. 

Level 6/BSC 2780 File Transmission 

The Level 6 configures BSC protocol on the desired communi¬ 
cations line for file transmission with an IBM system. The BSC 
directive must specify EBCDIC (see Section 6, "BSC Directive"). 
The same argument specifications listed above apply. 

MEMORY SIZE 

The memory requirements of the TRAN program, as detailed in 
the appropriate File Transmission manual, must be included to 
calculate the size of the system pool area as described in this 
manual. This is done to meet the requirement of shareable bound 
units. 

The memory pool associated with the task group(s) in which 
TRAN will be initiated must meet the size requirements of task 
group control, lead task control block, ECL task, plus the 
additional work spaces as detailed in the appropriate File 
Transmission manual. 

NOTE: A task group must be created for each concurrent 

execution of TRAN. The available memory for each 
group must, again, meet the size requirements as 
stated above. 
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APPENDIX H 

2780/3780 WORKSTATION FACILITY CONFIGURATION 


For the 2780/3780 Workstation Facility (WF) to interface 
effectively with the host system, the following Level 6 config 
uration environment must be established: 

• Noncommunication directives to define the following 
noncommunications aspects of the system software: 

System variables 

Characteristics and sizes of memory pools 

Physical and logical characteristics of peripheral 
devices used by the 2780/3780 WF. 

System overlays 

System software extensions 

• Two communications directives used to define the 
following: 

- The priority level at which the MLCP (Multiline 
Communications Procesor) interrupts the central 
processor (COMM communications directive) 

The binary synchronous line protocol handler (BSC 
communications directive) 1 

Use (or non-use) of multi-record feature 

Usage of both communications and noncommunications directives 
described in detail in this manual. 

Figure H-l shows a typical Level 6 configuration required 
to execute the 2780 WF. 


i For 2780 WF, the multi-block-count must be either 2 or 7 to 
match the host configuration. 


are 
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($H)DEVICE KSR00,0,5,X'0500',CONSOLE,140 
($H)SYS ,,,10,40,40,,E 
($H)DEVICE RCD01,4,9,X'1480' 

($H)DEVICE LPT00,5,18,X'1380',LPT00 
(#H)DEVICE CDROO,6,19,X'1300',CRD00 
($H)DEVICE DSK00,7,12,X'400' 

($H)DEVICE DSKOI,8,13,X'480' 

($H)DEVICE DSK02,9,14,X'1200 ' 

($H)DEVICE DSK03,10,15,X'1280' 

($H)COMM 20 

($H)BSC 22,22,X'FCOO',2,P,EB,7 Communications Directives 
($H)MEMPOOL S,,10000 

($H)MEMPOOL ,AB,* Noncommunications Directives 

($H) * 

($H)QUIT 

Figure H-l. Typical Level 6 Configuration to Execute the 
2780 WF 


Noncommunications 

Directives 
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APPENDIX J 


HASP WORKSTATION FACILITY CONFIGURATION 


For the HASP Workstation Facility (WF) to effectively 
interface with the host system, the following Level 6 environ¬ 
ment must be established: 

• Noncommunications directives to define the following 
noncommunications aspects of the system software: 

System variables 

Characteristics and sizes of memory pools 

Physical and logical characteristics of peripheral 
devices used by the HASP WF 

System software extensions 

• Two communications directives used to define the 
following: 

The priority level at which the MLCP (Multiline 
Communications Processor) interrupts the central 
processor (COMM communications directive). 

- The HASP line protocol handler (HASP communications 
directive) 

Figure J-l shows a typical Level 6 configuration required to 
execute the HASP WF. In this example, the Host,Link parameter 
(-N) could be any one of the following: -N 33, -N !HASP1, or -N 
>SPD>HASPl. 
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SYS ,,,10,20,20,, E 

DEVICE KSR00,0,5,X'0500',CONSOLE,140 
DEVICE RCD01,4,9,X'1480 ' 

DEVICE RCD02,5,10,X'1500' 

DEVICE RCD03,6,11,X'1580' 

DEVICE FCD01,8,9,X'1480' 

DEVICE FCD02,9,10,X'1500' 

DEVICE FCDO3,10,11,X'1580' 

DEVICE KSR01,11,12,X'0580' ,TTY01 

DEVICE DSK00,12,13,X'O4OO' 

DEVICE DSKOI,13,14,X'0480' 

DEVICE DSK02,14,15,X'1200' 

DEVICE DSK03,15,16,X'1280' 

DEVICE MT900,16,17,X'1600' 

DEVICE LPT00,17,18,X'1300',LPT00 

DEVICE CDROO,18,19,X'1300',DCROO 

COMM 25 

HASP 33,34,X'FC00' 

DEVICE HASP, 33,34,X'FC00',HASPi 

MEMPOOL S,, 10000 

MEMPOOL ,AB,* Noncommunications 

QUIT Directives 

Figure J-l. Typical Level 6 Configuration to Execute 
the HASP WF 


Communications 

Directives 


Noncommunications 

Directives 
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APPENDIX K 


PROGRAMMABLE FACILITY/3271 


NOTE: See the 3270 Interactive Facility User's Guide 

for Programmable Facility/3271 (PF/3271) 
operating instructions. 


After an initial system startup, invoke the Editor to 
build: (1) a CLM_USER file used in configuration of the system 
software that supports the PF/3271 and (2) a login terminals file 
used to describe the characteristics of each VIP 7200 terminal 
used in the dynamic login of VIP 7200 terminals. A Honeywell- 
supplied generation program (ZF32IN) must then be invoked to 
build an initialization file. If COBOL programming extensions 
are used in conjunction with PF/3271, the COBOL program must be 
linked to a special interface routine (ZCOBIF). The details of 
the initialization file, CLM_USER file, login terminals file, and 
COBOL interface are described in this Appendix. 


CLM_USER FILE 


The CLM_USER file is used to configure GCOS to support the 
PF/3271. The PF/3271 is composed of the following two bound 
units: (1) one defining the line protocol handler (LPH) for the 
host system and (2) one to define the application portion of the 
PF. The line protocol handler must be loaded at stage 2 system 
startup (see "Stage 2 System Startup (Intermediate System 
Startup)", Section 3). The directive that defines (loads) the 
line protocol handler for the host system is described in Section 
5 of this manual (see H3270 Directive). 

Configuration information identifying VIP 7200 terminals, on 
lines serviced by the Asynchronous Terminal Driver (ATD), is sup¬ 
plied through use of ATD directives (see Section 5 of this man¬ 
ual). when the system is rebooted, at stage 2 system startup from 
the CLM_USER file, a communications line is configured for each 
ATD terminal display plus one communications line for the host 
system. 


CLM-USER FILE EXAMPLE 

The following is a typical example of a CLM_USER file 
used in the generation of the PF/3271: 
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CLM_USER FILE 

DEVICE KSR00,0,5,X'0600','CONSOLE',140 
SYS 60,50,,2,20,60,5,E 
DEVICE LPT00,30,10,X'0680' 

COMM 7 

DEVICE ATDOO,13,9,X'FF80',VIP00,80,N 
DEVICE ATD01,14,9,X'FE80' ,VIP01,80,N 
DEVICE ATD02,15,9,X'FF00',VIP02,80,N 
DEVICE ATD03,16,9,X'FE00',VIP03,80,N 
DEVICE BSCOO,12,8,X'FCOO' ,BSC00 
DEVICE BSCO1,11,8,X'FC80',BSC01 
ATDOO 13,9,X'FF80' ,0,9600,'7200' 

ATD01 14,9,X'FE80' ,0,9600,'7200' 

ATD02 15,9,X'FFOO' ,0,9600 ,'7200' 

ATD03 16,9,X'FEOO’,0,9600,'7200' 

H3270 12,8,X'FCOO',0,X'40',X'60' 

H3270 11,8,X'FC80' ,2,X'40' ,X'60' 

MEMPOOL S,,17000 
MEMPOOL ,AB,* 

MEMPOOL ,AC,* 

MEMPOOL ,LO , * 

MEMPOOL ,LI,* 

MEMPOOL ,L 2 , * 

MEMPOOL ,L3 ,* 

QUIT 

In this example of a CLM_USER file, the following is shown: 

• Four ATDnn directives have been used causing four 
communications lines to be configured, one per VIP 
7200 terminal. 

• A DEVICE directive has been "provided" with each 
ATDOO directive so that each pair contains the 
same lrn, level, and channel number. 

NOTE: See "DEVICE Directive," in Section 5 of this 

manual. 

• Two H3270 directives have been used indicating that 
the line protocol handler (lph) will be loaded once 
defining two host system links. 

• A DEVICE directive has been "paired" with each H3270 
directive so that each pair contains the same lrn, 
level, and channel number. 

NOTE: See "DEVICE Directive," Section 5 of this manual. 

LOGIN TERMINALS FILE 


The login terminals file is used to describe the character¬ 
istics of each VIP 7200 terminal to be monitored by the listener ^ 

(a system software component) for access requests issued by the t 
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PF/3271. The file is created with the Editor and consists of: 

(1) variable-length G-, T- and A-type records and, optionally, 

(2) a LOGIN command. 

The following is an example of building a login terminals 
f ile. 

Example: 

Building the login terminals file (after initial system 
startup). 

Entries Comments 

Editor Commands And 
Directives: 


ED 

A 


Command to load the Editor 

Append directive used to enter 
login records (comprising the 
terminals file) into the current 
buffer 


Login Record Entries : 

G 1 3 
T VIPOO 
A A 
A B 
A C 


G-, T- and A-type records comprise 
this example of the login terminals 
file to be named "TERM1". In this 
example, only VIPOO will have access 
to host system links BSC01, BSC02 and 
BSC03. The host system links will be 
established through issuance of three 
separate login commands from the 
operator's console. 


Editor Commands And 
Directives: 


I F 


Editor escape character 


Print directive used to display 
contents of the current buffer. 


W TERM1 


Write directive used to write 
contents of the current buffer 
the login terminals file named 
TERM1. 


to 


QUIT 


Causes the Editor to cease reading 
commands and directives. 


The following example shows three possible login terminal 
files incorporating login commands. 
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Example: 


1. Building the login terminals file (after initial system 
startup). 

Entries Comments 

Editor Commands And 
Directives: 

ED Command to load the Editor 

A Append directive used to enter 

login records (comprising the 
terminals file) into the current 
buffer 


Login Record Entries: 
G 2 1 

T VIPOO L H0ST1 AA 
-ARG IBSC01 Cl 


Possibility #1 

G- and T-type record entries comprise 
this example of a login terminals 
file. In this example, only VIPOO 
has access to host link BSC01. 


G 2 3 
T VIPOO 

A A L H0ST1 AA 
-ARG !BSC01 Cl 
A B L HOST2 AB 
-ARG !BSC02 C2 
ACL HOST3 AC 
-ARG !BSC03 C3 


Possibility #2 

G-, T- and A-type records comprise 
this example of a login terminals 
file. In this example, only VIPOO 
has access "to host links BSC01, BSC02, 
and BSC03 because the T-record pre¬ 
cedes the A-records. 

Note: If multiple T-records precede 

the A-records, only the last 
entered T-record is recognized. 


G 2 4 

A A L HOST1 AA 
-ARG !BSC01 Cl 
A B L HOST2 AB 
-ARG !BSC02 C2 
ACL HOST 3 AC 
-ARG !BSC03 C3 
T VIPOO 
T VIP01 
T VIP02 
T VIP03 


Possibility #3 

G-, A- and T-type records comprise 
this example of a login terminals 
file. In this example, all VIPs 
have access to host links BSC01, 
BSC02 and BSC03 because the T- 
records follow the A-records. 
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Editor Commands And 
Directives: 


! F 

Editor escape character 

P 

Print directive 
contents of the 

used to display 
current buffer. 

W TERM1 

Write directive 
the contents of 
(for one of the 

is used to write 
the current buffer 
previous three 


possibilities) to a login terminals 
file named TERM1. 

QUIT QUIT directive causes the Editor to 

cease reading directives. 

INITIALIZATION FILE 

The initialization file is used to define the site-specific 
information used to interface with the PF/3271. A Honeywell- 
supplied generation program, ZF32IN, is provided to perform the 
following: 

• Create the initialization file 

• Update an existing initialization file 

• List (partially or totally) an existing initialization 
file on t the operator's console 

The generation program operates in an interactive mode consist¬ 
ing of alternating questions and responses between the gener¬ 
ation program and you. Depending on the site-specific informa¬ 
tion to be included in the initialization file, two levels of 
functionality are provided by the generation program. 

Level 1 Functionality 

At this level, the generation program allows the following 
initialization file/record manipulation: 

• Inclusion of records defining host system linkages 
(through use of the HOST directive, described later 
in this appendix). 

• Deletion of existing host system records and affiliated 
device assignment records (through use of the DELETE 
directive, described later in this appendix). 

• Positioning of the initialization file to either receive 
new device assignment records or update existing device 
assignment records affiliated with host system records 
(through use of the POSITION directive, described 

later in this appendix). 


e 


K-5 


CB23-03 



• Listing, on the operator's console, of all information 
pertaining to either: (1) all records defining host 

system linkages or (2) a specific record defining V 

a host system linkage (in both cases, through use 
of the CURRENT directive, described later in this 
appendix). 

• Specification of the number of Screen Image Buffers 
(through the BUFFERS directive, described later in this 
appendix). 

Directives, which interface with the generation program 
in the interactive mode, are used to implement the previously 
described initialization file/record manipulation. Table 
K-l shows the Level 1 directives which are used to define host 
system linkages. 


Level 2 Functionality 

At this level, the generation program allows the following 
initialization file/record manipulation: 


• Definition of device (address) assignment records 
(through use of the PRINTER, VIRTUAL and SCREEN 
directives). 




Updating or deletion of device (address) assignment 
records (through use of the Y, N and D directives). 


Directives, which interface with the generation program 
in the interactive mode, are used to implement the previously 
described initialization file/record manipulation. Table 
K-2 shows the Level 2 directives which are used to define 
or update device (address) assignment records. Depending 
on the desired application, both Level 1 and Level 2 directives 
can be used together. 

In the format descriptions shown in the tables which 
follow, brackets ([ ]) enclose optional arguments and 
braces ({ }) indicate a choice. 


A 

V 
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Table K-l. Level 1 Directives 


Generation 

Prompts 


Program 


Level 


1 


Directives/Responses 


ENTER CURRENT FILENAME 


Enter name of new initialization 
file to be created or existing 
file previously created by presen 
generation program. 


t 


ENTER CURRENT OR HOST 
WITH PATHNAME, BUFFER 
OR QUIT 


name consists of from 1 to 12 alpha¬ 
numeric characters; the first char¬ 
acter must be alphabetic or a dollar 
sign ($). 

HOST pathname [block size] 

CURRENT [pathname] 

BUFFERS nn 
QUIT 

HOST 

If a new pathname is specified, 
entry of this directive creates 
a new host system record in the 
initialization file which defines 
the host system linkage. 

pathname consists of !xxxx, 
where xxxx represents a commun¬ 
ications device_unit (see "DEVICE 
Directive," Section 5 of this 
manual). 

blocksize (nnnn) uses a default 
value of 2000 if not otherwise 
specified. 


If the host system record already 
exists, you can position, delete 
or update host system records or 
device (address) assignment 
records (see POSITION and DELETE 
directives, late& in this table). 


If you decide to position records, 
you can then choose to update 
device (address) assignment rec¬ 
ords (see PRINTER, VIRTUAL and 
SCREEN directives. Table K-2, 
later in this appendix). 
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Table K-l (cont). Level 1 Directives 
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Table K-l (cont) . Level 1 Directives 


Generation Program 
Prompts 

Level 1 Directives/Responses 

DO YOU WISH TO POSITION 
OR DELETE? 

NOTE: The prompt ENTER CURRENT OR 

HOST WITH PATHNAME, BUFFER 

OR QUIT again appears 
following the BUFFERS 
entry. 

QUIT 

Entry indicates the initialization 
file will be closed and generation 
program ZF32IN will be exited. 

( POSITION \ 

(DELETE j 

POSITION 

Entry positions the initialization 
file to receive new device 
(address) assignment records or to 
update existing device (address) 
assignment records. Once the file 
is positioned, entry or updating 
of device assignment records can 
occur following the prompt: 

ENTER COMMAND OR QUIT (see 

Table K-2 for details) . 

DELETE 

Entry deletes a specified (via 

HOST directive) host system record 
and any device (address) assign¬ 
ment records affiliated with it. 
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Table K-2. Level 2 Directives 


Generation Program 
Prompts 


ENTER 

QUIT 


Level 2 Directives/Responses 


COMMAND OR 


( PRINTER dn pathname 
VIRTUAL dn pathname 
SCREEN dn [pathname] [1920] 


PRINTER dn pathname 

Entry indicates a printer device 
(address) assignment. 

dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. 


If the device (address) assignment 
record (affiliated with the par¬ 
ticular host system record) has 
not been previously defined, a new 
device (address) assignment record 
will be created. However, if the 
device (address) assignment record 
has been previously created, you 
must either update or delete the 
device (address) assignment record. 

NOTE: Update and delete functions 
are described later in this 
table. 

pathname consists of !xxxx, 
where xxxx represents a standard 
device_unit (see "DEVICE 
Directive," Table 4-2 in this 
manual). 

VIRTUAL dn pathname 


Entry indicates an application pro¬ 
gram device (address) assignment. 










Table K-2 (cont). Level 2 Directives 


Generation Program 
Prompts 



Level 2 Directives/Responses 


dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. If the 
device (address) assignment record 
(affiliated with the particular 
host system record) has not been 
previously defined, a new device 
(address) assignment record will be 
created. However, if the device 
(address) assignment record has 
been previously created, you must 
either update or delete the device 
(address) assignment record. 

NOTE: Update and delete functions 
are described later in this 
table. 

pathname consists of the pathname 
of the application program access¬ 
ing the virtual device. For a 
description of pathnames, see the 
appropriate Operator's Guide. 


SCREEN dn [pathname] [1920] 


Entry indicates a VIP 7200 terminal 
display unit. 

dn consists of a valid device 
address selected from Table K-4, 
later in this appendix. If the 
device (address) assignment record 
(affiliated with thb particular 
host system record) has not been 
previously defined, a new device 
(address) assignment record will be 
created. However, if the device 
(address) assignment record has 
been previously created, you must 
either update or delete the device 
(address) assignment record. 

NOTE: Update and delete functions 
are described later in this 
table. 
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Table K-2 (cont). Level 2 Directives 


Generation Program Level 2 Directives/Responses 

Prompts 


Optional; pathname is the pathname 
of the user's application program. 

NOTE: Level 1 directives HOST, 
CURRENT or BUFFERS can be 
entered following the prompt: 
ENTER COMMAND OR QUIT. How¬ 
ever, the effect will be to 
terminate any other entries, 
update any device (address) 
assignment records and return 
to Level 1 processing (see 
Table K-l, earlier in this 
appendix). 


UPDATE OR DELETE EXIST¬ 
ING DEVICE ADDRESS? 
(YES, NO, DELETE) 


Y [ES] 

Entry indicates device (address) 
assignment record will be updated 
with information previously entered 
through a device (address) assign¬ 
ment record. 


N [0] 

Entry indicates device (address) 
assignment record will not be 
deleted. 

D[ELETE] 

Entry indicates device (address) 
assignment record will be deleted 
(in effect, disassociated from the 
current host system record). 
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Error Messages 


The following error messages, shown in Table K-3, are 
produced by the generation program. 


Table K-3. Error Messages 


Error Messages 


Description 


ILLEGAL PATHNAME 


The pathname used on a CURRENT direc¬ 
tive could not be located. The follow¬ 
ing generation program prompt is 
repeated: ENTER CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 


PATHNAME MISSING 


INVALID DEVICE: 
COMMAND IGNORED 


INVALID PARAM 


Either: 

(1) A HOST directive without a 
pathname was entered. The 
following generation program 
prompt is repeated: ENTER 
CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 

Or : 

(2) A PRINTER or VIRTUAL direc¬ 
tive without a pathname was 
entered. The following 
generation program prompt 
is repeated: ENTER COMMAND 
OR QUIT. 

PRINTER, VIRTUAL or SCREEN directive 
does not have proper device (address) 
assignment (see Table K-4 for proper 
device addresses). The following 
generation program prompt is repeated: 
ENTER COMMAND OR QUIT. 

For the BUFFER directive, nn exceeds 
two digits. The following generation 
program prompt is repeated: ENTER 
CURRENT OR HOST WITH PATHNAME, BUFFER 
OR QUIT. 

For the HOST directive, nnnn (block- 
size) exceeds four digits. The follow¬ 
ing generation program prompt is 
repeated: ENTER CURRENT OR HOST WITH 
PATHNAME, BUFFER OR QUIT. 
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Device Or 

Control Unit 

1 Numbers 

Addresses 

0 

40 

1 

Cl 

2 

C2 

3 

C3 

4 

C4 

5 

C 5 

6 

C6 

7 

C7 

O 

u 

C8 

9 

C9 

10 

4A 

11 

4B 

12 

4C 

13 

4D 

14 

4E 

15 

4F 
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Table K-4 (cont). Device Addresses 


Device Or 

Control Unit 

Numbers 

Addresses 

16 

50 

17 

Dl 

18 

D2 

19 

D3 

20 

D4 

21 

D5 

22 

D6 

23 

D7 

24 

D8 

25 

D9 

26 

5A 

27 

5B 

28 

5C 

29 

5D 

30 

5E 

31 

5F 


Examples of Initialization Files 

In Example 1, an initialization file has been created 
containing one host system record and its associated device 
(address) assignment records: 

Example 1 

RDY: 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TESTFL 


ENTER CURRENT 
BUFFERS 06 

OR 

HOST 

WITH 

PATHNAME, 

BUFFER 

OR 

QUIT 

ENTER CURRENT 
HOST IBSC1 

OR 

HOST 

WITH 

PATHNAME, 

BUFFER 

OR 

QUIT 

ENTER COMMAND 

OR 

QUIT 







PRINTER Cl !LPT01 
ENTER COMMAND OR QUIT 
PRINTER C2 !LPT02 
ENTER COMMAND OR QUIT 
SCREEN Dl, PROG1 
ENTER COMMAND OR QUIT 
SCREEN,D2, PROG1 
ENTER COMMAND OR QUIT 
SCREEN,D3, PROG1 
ENTER COMMAND OR QUIT 
VIRTUAL 5A >DONW>PROGl 
ENTER COMMAND OR QUIT 
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Example 1 (cont) . 

CURRENT 

CURRENT DEVICE ASSIGNMENTS: 

BUFFER COUNT 06 
NUMBER OF HOSTS 01 
HOST LINK IBSC1 
BLOCKING 0512 
SCREEN D1 1920 PROG1 
SCREEN D2 1920 PROG1 
SCREEN D3 1920 PROG1 
VIRTUAL 5A >DONW>PROGl 
PRINTER Cl !LPT01 
PRINTER C2 !LPT02 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
QUIT 

In Example 2, an initialization file has been created 
containing two host system records and their associated 
device (address) assignment records: 

Example 2: 

RDY: 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TESTF1 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

HOST !BSC1 256 

ENTER COMMAND OR QUIT 

PRINTER Cl !LPT01 

ENTER COMMAND OR QUIT 

PRINTER C2 !LPT01 

ENTER COMMAND OR QUIT 

SCREEN Dl, PROG1 

ENTER COMMAND OR QUIT 

SCREEN D2, PROG1 

ENTER COMMAND OR QUIT 

SCREEN D3, PROG1 

ENTER COMMAND OR QUIT 

VIRTUAL 5A >DONW>PROGl 

ENTER COMMAND OR QUIT 

BUFFERS 09 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

HOST !BSC2 1024 

ENTER COMMAND OR QUIT 

PRINTER C3 !LPT03 

ENTER COMMAND OR QUIT 
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Example 2 (cont) ■ 

PRINTER C4 !LPT04 
ENTER COMMAND OR QUIT 
SCREEN,D4,1 TTY04 
ENTER COMMAND OR QUIT 
VIRTUAL 5F >DONW>PROG2 
ENTER COMMAND OR QUIT 
CURRENT 

CURRENT DEVICE ASSIGNMENTS: 

BUFFER COUNT 09 
NUMBER OF HOSTS 02 

HOST LINK !BSC 1 
BLOCKING 0256 
SCREEN D1 1920 PROG1 
SCREEN D2 1920 PROG1 
SCREEN D3 1920 PROG1 
VIRTUAL 5A >DONW>PROGl 
PRINTER Cl !LPT01 
PRINTER C2 !LPT02 

HOST LINK !BSC2 
BLOCKING 1024 
SCREEN D4 1920 PROG1 
VIRTUAL 5F >DONW>PROG2 
PRINTER C3 !LPT03 
PRINTER C4 !LPT04 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

QUIT 

RDY: 

In Example 3, an initialization file (containing the host 
system records created in Example 2) is positioned to the 
second host system record, and updating and deletion functions 
are performed on existing device (address) assignment records: 
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Example 3 


RDY: 

ZF32IN 

3271 INITIALIZATION PROGRAM 9066 

ENTER CURRENT FILENAME 

TESTF1 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 
HOST !BSC2 

DO YOU WISH TO POSITION OR DELETE? 

POSITION 

ENTER COMMAND OR QUIT 
SCREEN,5F,!TTY05,1920 

UPDATE OR DELETE EXISTING DEVICE ADDRESS?(YES,NO,DELETE) 
YES 

ENTER COMMAND OR QUIT 
PRINTER C4 !LPT04 

UPDATE OR DELETE EXISTING DEVICE ADDRESS?(YES,NO,DELETE) 
DELETE 

ENTER COMMAND OR QUIT 
CURRENT 

CURRENT DEVICE ASSIGNMENTS: 

BUFFER COUNT 09 
NUMBER OF HOSTS 02 

HOST LINK 1BSC1 
BLOCKING 0256 
SCREEN Dl 1920 PROG1 
SCREEN D2 1920 PROG1 
SCREEN D3 1920 PROG1 
VIRTUAL 5A >DONW>PROGl 
PRINTER Cl !LPT01 
PRINTER C2 !LPT02 

HOST LINK !BSC2 
BLOCKING 1024 
SCREEN D4 1920 PROG1 
SCREEN 5F 1920 PROG1 
PRINTER C3 ILPT03 

ENTER CURRENT OR HOST WITH PATHNAME, BUFFER OR QUIT 

QUIT 

RDY: 



COBOL Interface Program 


To run a COBOL program on the PF/3271, the COBOL program 
needs a special interface. The object module of the COBOL 
program must be linked with the Honeywell-supplied interface 
program (ZCOBIF). The following is an example of creating 
such a bound unit: 


LINKER XXXXXX 
LIB > ZCIRT 

LINKN ZCOBIF, YYYYYY; MAP; QUIT 

where XXXXXX is the bound unit name assigned by the user 
and YYYYYY is the name of the COBOL program object file. 
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APPENDIX L 


LISTENER COMPONENT AND LOGIN CAPABILITY 


INSTALLING A SYSTEM LOGIN CAPABILI TY 

The listener component enables access to the system from a 
designated set of terminals. It must run as the lead task of 
task group $L, and can be activated using commands in the system 
START_UP.EC file or by entering commands from the operator 
terminal after system startup is complete and the system is 
operational. 

When the listener is active, a user can log in to the system 
from the noncommunications terminals (MDC-connected) or commun¬ 
ications terminals (MLCP/DLCP-connected) listed in a "terminals" 
file. The terminals monitored by listener for a login command 
cannot be directly reserved by system applications. 

To provide a system with the login capability, make the 
following preparations: 

1. Create the terminals file which describes the login 
characteristics of each terminal to be used for login. 
This file determines in which one of three ways login 
is to be achieved. A terminal can (a) require a LOGIN 
command typein, (b) allow a user to type an abbreviation 
for the login command line, or (c) be immediately logged 
in, without a typein, when it is ready or connected. 

2. Allocate memory pools for login by use of the CLM 
MEMPOOL directive. 

Once these preparations are completed, you can activate 
the listener as the lead task of task group $L. Listener 
activation is described later in this appendix. 
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MEMORY POOLS FOR LOGIN TASKS 


When you log in as a primary user at a terminal, a task group 
is spawned which has that terminal as its user_in and user_out 
files. When you enter a LOGIN command, you may specify the task 
group identification (a two-character group id) or accept a 
default group id. For each task group to be spawned by a LOGIN 
command, you must define a memory pool whose pool_id is the same 
as the group_id. The first character of a default group_id/pool_ 
id is an alphabetic character that may be specified by the user 
when the listener is activated. If no character is specified, 
the letter L becomes the first character. The second character 
is the next unused character from the sets 0,...,9 and A,...,Z. 

If only defaults are taken, the number of default pools must at 
least equal the number of users who may concurrently gain access 
to the system. This number is specified in the G-record of the 
terminals file. You can define pools that are completely over¬ 
lapping by specifying each pool in a separate MEMPOOL directive. 
(This also applies to any other type of memory pool that you wish 
to define.) For example, to make available all of the nonexclu¬ 
sive pool area for three users who accept default pool_ids, use 
the following directives: 

MEMPOOL ,L 0,* 

MEMPOOL ,L1,* 

MEMPOOL ,L 2,* 

Additiona1-examples illustrating the allocation of memory are 
included in the description of the MEMPOOL directive. 

TERMINALS FILE 

Listener determines which terminals to monitor for system 
access from information in a terminals file. The pathname of 
the terminals file may be specified in the command that requests 
the listener task, or may be defaulted to >SID>TERMINALS. The 
file is created with the Editor and consists of variable-length 
G-,T-, and A-type records. Arguments within a record are sep¬ 
arated by one or more blank characters. For a terminal to have 
the direct login characteristic, the LOGIN command must be 
specified in the T-record for that terminal. 

For a terminal to have the option of accepting abbrevia¬ 
tions for LOGIN commands it requires A-records with the desired 
command line image and the absence of a login line in the 
T-record for that terminal. One or more abbreviations can be 
specified. The A-records following a T-record are associated 
only with that terminal. The A-records following the G-records 
allow all terminals to use those abbreviations for command 
lines. When the same abbreviation is used in an A-record fol¬ 
lowing a G-record, and in an A-record following a T-record, the 
command line image in the A-record following the T-record is 
used for the terminal. The layout of the records of the termi¬ 
nals file is shown below. 
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G-Record In Login File 

There is one G-record in the login terminals file, in the 
format: 

G base lvl max user 


base_lvl 

Level, relative to the lowest numeric (highest priority) 
level not used by the system group, on which the lead 
task of a group spawned by listener for a terminal is to 
execute unless a level is specified in the login line. 

max_use r 

Maximum number of concurrent logged-in users allowed 
on the system. This value does not include task groups 
created or spawned by commands other than LOGIN. Logins 
that exceed this limit are terminated and the listener 
issues the message 

3915 NUMBER OF CURRENT USERS EXCEEDS THE MAXIMUM 
T-Record In Login File 

There is one T-record in the terminal login file for each 
terminal on which a user may log in, in the format: 

T [A] dev name [login_line] 


A 


Specifies that only abbreviated logins will be allowed at 
this terminal. If a user specifies a nonabbreviated 
login line at this terminal, the listener issues the fol¬ 
lowing error message: 

3916: LOGIN MUST BE BY ABBREVIATION 
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dev name 


Symbolic device name of the terminal, as specified at 
configuration. 

login_line 

The login command line image (including the LOGIN or L 
characters) used instead of a user typein when a terminal 
is to be used for direct login. 

A-Record In Login File 

An A-record contains an abbreviation character and the assoc¬ 
iated LOGIN command line image that the listener will use when 
a user types in the abbreviation. A variable number of A-records 
may follow the G-record and/or any T-record. When a user enters 
an abbreviation, listener scans the A-records following the 
T-record for that terminal and if a match is found, uses that 
login line for logging in. If the abbreviation is not found, 
listener scans the A-records following the G-record for a match, 
and if a match is found, uses that login line for logging in. 

If no match is found, the listener issues the message: 

39OE ABBREVIATION FOR TERMINAL NOT FOUND 
The format for the A-record is: 

A abbrev login_line 


abbrev 

A 1-character abbreviation that a user can optionally 
type in when logging in on this terminal. 

login_line 

The LOGIN command line image associated with the 
abbreviation. 

LOGIN COMMAND 


The abbreviated description of the LOGIN command that follows 
shows the type of entries that may be included„in the A- and 
T-records of the terminals file. For a detailed description of 
the LOGIN command, see the Commands manual. Note that the length 
of the login command line is limited to 110 characters. 

The LOGIN command causes (1) a task group associated with the 
user's terminal to be spawned, or, (2) the terminal to be 
attached to an existing task group as a secondary terminal. Once 
he has access to the system, the user cannot again invoke login 
unless he first uses the BYE command or the task group is other¬ 
wise terminated. 


L-4 


CB23-03 



FORMAT: 


L login_id [destination_id] [ctl_arg] 
ARGUMENT DESCRIPTION: 


login id 


Establishes the identity of 
gain access to the system, 
for the spawned task group, 
of from one to three fields 


the user who is attempting to 
Provides the user identification 
The login_id argument consists 
having the following meanings: 


person 

person.account 
person.account.mode 


person 

Name of person who may access system; can be from 
1 through 12 characters. (For example, WDSMITH 
could be the value for the person field.) 

account 


Name of an account under which the user is to 
work; can be from 1 through 12 characters. (For 
example, JSINVENTORY could be used as the value 
for the account field.) 


mode 


Provides a further identification of the user; 
can be from 1 through 3 characters. (For ex¬ 
ample, VER could be used as the value for this 
field.) 

[destination_id] 

Optional argument that permits the user to log in as a 
secondary user of an existing task group. (A request 
for a secondary user terminal must have been previously 
issued by that task group.) To log in as a secondary 
user of a user-created applications program, enter the 
value id, where id is the task group id of the task group 
in which the application is running. If this argument is 
specified, no other control arguments may be specified. 

[ctl_arg] 

None or any number of the following control arguments can 
be selected: 
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-PO 


[ level ] 


(* H* 1 

jpathlkidj 


Used to override 
id, and relative 
group spawned as 


the default lead task, group id/pool 
level specifications for the task 
a result of this login procedure. 


path 


Pathname of the bound unit to be executed as the 
lead task of the spawned task group. If the star 
character (*) is entered the lead task is the 
command processor. 


id 


Group_id/pool_id of the spawned task. The group_ 
id and the pool_id are represented by the same ~ 
2-character value. If this argument is not spec¬ 
ified, a default id is assigned as for memory 
pools. 

Default: The group id is a 2-character value 

whose first character was specified 
when the listener component was 
activated and whose second character is 
the next unused character in the 
sequence 0 through 9 and A through Z, 
assigned by the system. 

level 

Base priority level at which the spawned group is 
to execute (relative to the system group level). 

A base level of 0 is the next higher level. The 
sum of the highest system physical level plus 1, 
and the base level of the group, and the relative 
level of a task within that group, must not 
exceed 62 (decimal). 

Default: The base priority level is that speci¬ 

fied in the terminals file, relative to 
the system group level. 

ii n w ~ i. u 
—n u \ja uii 

Used to specify the home directory for the task 
group spawned as a result of the login procedure. 
The home directory is your initial working direc¬ 
tory when you log in under an account. 


L-6 


CB23-03 



path 


Pathname of the initial working directory for 
the spawned task group. You must specify a 
full or relative pathname (not a simple path¬ 
name) . If this argument is omitted, the 
working directory pathname is null. 


LRN n 

Used to override the default maximum logical 
resource number (LRN) value for the task group 
spawned as a result of this login procedure. 

n 

Maximum LRN value to be used for the spawned 
task group. (The maximum possible LRN value 
is 252.) If this argument is omitted, the 
maximum LRN value is 1. 

LFN n 

Used to override the default logical file number 
(LFN) value for the task group spawned as a re¬ 
sult of the login procedure. 

n 

Maximum LFN value to be us'ed for the spawned 
task group. (The maximum possible LFN value 
is 255.) If this argument is omitted, the 
maximum value is 15. 

HOLD 

Set the current connect/disconnect device¬ 
specific word to specify that the terminal is to 
be disconnected without phone hangup. This argu¬ 
ment allows you to reuse the terminal without 
redialing after logging off the system. (See the 
set terminal * characteristics (STTY) command or 
directive for information about the connect/ 
disconnect device-specific word.) 

Default: The terminal will be disconnected 

according to the setting of the current 
connect/disconnect device-specific 
word. 

ARG arg arg . . . arg 

to pa-ss additional arguments to the lead 
of the task group spawned as a result of 
login procedure. 


Used 

task 

this 
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LISTENER ACTIVATION 


Listener is activated with the CG (create group) and EGR 
(enter group request) operator commands, or with an SG (spawn 
group) operator command, using the arguments shown below. 1 
These commands and their arguments are described in the Commands 
manual. 


CG $L base lvl -EFN LISTENER -POOL id 


('path '\ 
("path "/ 


EGR $L use r_id -OUT !CONSOLE -ARG 
SG $L user_id base_lvl -EFN LISTENER -POOL id 
-OUT ICONSOLE - ARG 


('path '( 
("path "/ 


[x] ["message"] 


[x] ["message"] 


'path '( 

"path "f 

Pathname of the terminals file, which lists the 
terminals on which users may log in, and which 
contains the terminal characteristics records. 


The last character in the pathname must be a 
blank and the entire pathname must be enclosed in 
either single or double quotes. An omitted 
(default) pathname must be written as a pair of 
enclosing single or double quotes (' ') or (" "), 

and results in the default pathname 
>SID>TERMINALS. 


[x] 


The first character in the 2-character pool_id 
and group_id when default values are used. The 
second character, from 0 through 9 or A through 
Z, is appended when a task group is spawned as a 
result of the LOGIN command. When this argument 
is omitted, its default value is L. 

When a user specifies a group_id* in a LOGIN com¬ 
mand or in a login line for a T-record or A- 
record, listener uses that as a group_id instead 
of generating a group_id. 


i Once activated, listener can be terminated only if the system 
shuts down, or by using the -QT argument of the SET_LISTEN oper¬ 
ator command. Once terminated, the $L task group can be recre¬ 
ated as described below. 
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["message"] 

The message-of-the-day, enclosed in quotes to 
provide for embedded blanks, which listener 
transmits to all terminals for display. 

Terminal State After Listener is Activated 


When first activated and again when the session terminates, 
listener performs specific operations affecting the state of a 
terminal. The output on the terminal that a user sees and the 
state of the terminal depend on whether it is a noncommunications 
or a communications terminal. 

NONCOMMUNICATIONS TERMINAL STATE WITH LISTENER 

If a terminal is not ready when listener is activated, no 
initial output messages from listener are displayed when the ter¬ 
minal comes on line. 

When listener is activated: 

1. If there are terminals online, ready for direct login, 
they display the message-of-the-day. A task group is 
spawned for each such terminal if the login__line image 
contained in that terminal's T-record in the terminal 
login file specifies primary login. The lead task 
defined in the login line is executed. The application 
should display a prompter message to the terminal indi¬ 
cating that it is ready to accept input. When the lead 
task terminates, the message-of-the-day is displayed and 
a task group is immediately spawned again. 

If the login line in the terminal's T-record specifies 
secondary login, the terminal is given to the group named 
in the destination field, provided that the group has an 
outstanding request for a secondary terminal. The group 
returns the terminal to listener's control by executing a 
release terminal macro call. 

2. Terminals that require a user login, display the message- 
of-the-day and the user login prompter message identify¬ 
ing the system and giving the date and time: 

LOGIN system id yyyy/mm/dd hhmm:ss.t 

The user can then type in the LOGIN command. When the 
lead task terminates, the message-of-the-day is displayed 
followed by the login prompter message. 
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COMMUNICATIONS TERMINAL STATE WITH LISTENER 

Although a communications terminal may not be ready when the 
listener is activated, listener displays a message when the ter¬ 
minal comes online. Otherwise, when listener is activated, the 
same operations are done for communications terminals as for non¬ 
communications terminals described above. 

When a terminal is released: 

1. A terminal connected by phone and with the hangup 
option, is disconnected. The user must dial in again to 
use the terminal. 

2. A terminal connected through a modem bypass or by phone 
without the hangup option, displays the message-of-the- 
day; either the login prompter message is displayed or, 
for a direct login, a login task group is spawned. 

CHANGING THE LOGIN MESSAGE OF THE DAY 

After listener is activated, it places an operator response 
request to the operator terminal. The request number must be 
used in the response to listener from the operator terminal that 
changes the message-of-the-day. The message to the listener can¬ 
not exceed 63 characters and is in the form: 

Amsg_noAmessage-of-the-day 
EXAMPLES OF LISTENER OPERATION 

For these examples, the CLM file includes the following 
directives: 


DEVICE 

KSR01,11,21,X'0580' 

,KSR01 

DEVICE 

KSR02,12,22,X'0600' 

,KSR0 2 

MEMPOOL 

S , , 10000 


MEMPOOL 

, L 0 , * 


MEMPOOL 

, L 1, * 


MEMPOOL 

, M1, * 


MEMPOOL 

, AB, * 



Note that memory pools LO, LI, Ml, and AB all share the same 
memory. 


A \ 
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Example 1 ; 

The terminals file for this example has the pathname 
"ZSYS51>TERM>T1 and contains the following records: 

G 1 3 

T KSR01 

A X L X.X.X 

A Y L Y.Y.Y -P0 * Ml -HD ~ZSYS51>SYSLIB2 -LRN 40 -LFN 20 
T KSR02 
AWL W.W.W 

The listener is activated by command 1 made through the oper¬ 
ator terminal. Commands 2,3, and 4 illustrate alternative logins 
made through terminal KSR01. Note that they cannot be executed 
in sequence unless each is terminated with a BYE command. 

Command 1: 

A$S SG $L A 10 -EFN LISTENER -POOL AB -OUT !CONSOLE 

-ARG '' , ZSYS51>TERM>T1A' 


Command 2: 

AX 

Command 3: 

AY 

Command 4: 

AW 

The operations that result from each command are as follows: 

Command 1: Spawns group $L with a user_id of A, a relative 
level of 10, bound unit of listener as the lead 
task, uses memory pool AB, the in_path and out_ 
path is the console and argument passed to lis¬ 
tener is the location of the terminals file. The 
character used for default_value of the first 
character of pool_id and group_id was not given 
and this defaults to L. 
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Command 2: Listener spawns group LO with a user_id of X.X.X, 
lead task of command processor. The command pro¬ 
cessor issues the message: 170222 (No Working 
Directory) because -HD option was not used. 

User may continue after typing in a CWD command. 

Command 3: Spawns group Ml with a working directory of 

~ZSYS51>SYSLIB2 and the lead task is the command 
processor. 


Command 4: Because the A record is under the T record for 

KSR02 and not under the G record or the T record 
for KSR01, the listener issues the message 

390E ABBREVIATION FOR TERMINAL NOT FOUND 


For a valid login, the W must be typed in on 
KSR02. 


Ex ample 2 : 


The terminals file for this example has the pathname 
~ZSYS51 >TERM>T2 and contains the following records: 

G 1 3 

A Z L Z.Z.Z -PO >SYSLIB2>PR Ml -HD ~ZSYS51>SYSLIB2 
-ARG >SID>CLMJJSER -SP 1 

T KSR01 
T KSR02 

The listener is activated by command 1 made through the oper¬ 
ator terminal. Command 2 is a login made through terminal 
KSR01. 

Command 1: 

A$S SG $L B 10 -EFN LISTENER -POOL LO -OUT !CONSOLE 

-ARG ’~ZSYS51>TERM>T2A' 


Command 2: 

AZ 

The operations that result from each command are as follows: 

Command 1: Spawns group $L with a user_id of B, a relative 
level of 10, bound unit of listener as the lead 
task; uses memory pool LO; the argument passed to 
listener is the location of the terminals file. 
The first character of pool_id and group_id was 
* not specified and defaults to L. 
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Command 2: Spawns group Ml which prints CLM_USER and then 
terminates. 

Example 3 : 

The terminals file for this example has the pathname 

~ZSYS51>TERM>T3 and contains the following records: 

G 1 3 

T KSR01 L A.A.A 

The listener is activated by the following command which is 

made through the operator terminal. 

A$S SG $L C 10 -EFN LISTENER -POOL Ml -OUT 1CONSOLE 

-ARG '~ZSYS51>TERM>T3A' M 

This is an example of direct login. The login command is 
specified in the T record. The spawn group command, typed on the 
operator terminal, spawns listener group $L which uses memory 
pool Ml. Listener then spawns group Ml with the command proces¬ 
sor as the lead task. Ml as its memory pool, and KSR01 as user_in 
and user_out. 

The functionality of this spawn group command can also be 
achieved by the joint use of the create group and the enter group 
request commands as shown below. 

CG $L 10 -EFN LISTENER -POOL Ml 

EGR $L C -OUT !CONSOLE -ARG '~ZSYS51>TERM>T3A' M 

A message enclosed in quotation marks may be added to the entries 
following -ARG. This message will appear on the terminal when 
the group is activated. 
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APPENDIX M 
M4 SYSDEF CHECKLIST 


I 


This appendix is included as a convenience for users of the 
M4 SYSDEF utility. You can use the checklist provided to write 
down information which the utility requires to generate your 
directive file. The information you write down on the checklist 
will be requested by the utility in the same order. 

Note that this checklist does not include all the questions 
which the utility asks. For example, it doesn't list whether VIP 
devices support form feed. Also, the number of spaces provided 
for writing information about peripheral devices isn't meant to 
imply any limits on how many devices of a given type you can 
include in your configuration. 
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M4 SYSDEF CHECKLIST 


ITEM (Options/Units) 


1) 

Total amount of physical memory 

(nnnK) 


2) 

Default peripheral channel numbers? 

(YES/NO) 



(If YES, ignore "Channel number" 
entries for noncommunications 
devices) 



3) 

Commercial system (Model 47/57)? 

(YES/NO) 


4) 

(If NO to #3): Simulator? 

(YES/NO) 


5) 

Scientific processor? 

(YES/NO) 


6) 

(If NO to #5): Simulator? 

(YES/NO) 


7) 

System identification message: 




(Default: "GCOS 6/MOD400") 



8) 

Installation identification: 




(Default: "YOUR TOWN, USA") 



9) 

Maximum number of concurrent users: 



10) 

Default SPD names? 

_ (YES/NO) 



(If YES, ignore "SPD name" column 
of subsequent entries) 



ID 

Record locking? 

_ (YES/NO) 


12) 

Display Formatting and Control 

Software? 

_ (YES/NO) 


13) 

Power fail restart? 

_ (YES/NO) 


14) 

Communications devices? 

_ (YES/NO) 



(If NO, skip items 15 through 21) 



15) 

Number of communications priority 
levels: 

(1 through 

4) 

16) 

Number of MLCPs: 

(1 through 

10) 
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ITEM 


(Options/Units) 


17) MLCP-connected asynchronous terminals: 


Comm. 

SPD Channel priority Device 
name number level type 


18) 


VIP 7700's or VIP 7800's to be run in VIP 7700 emulation 
mode : 


Channe 1 
numbe r 


Comm. 

priority ROP 
level type 


19) H3270 Host Links: 


Comm. Polling 
SPD Channel priority address 
name, number level (dec.) 


Select 
address 
(dec.) 
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ITEM 


(Options/Units) 


20) Polled VIP Emulation Groups: 


Comm. 

SPD Channel Stations/ priority 
name number channel level 


Polling 
address 
1 2 


3 4 


21) Synchronous Terminals: 


SPD Channel VIPs/ 
name number channel 


Comm. Control 

priority station? ROP 
level (YES/NO) type 


22) Binary synchronous communications lines: 


Comm. 

Channel priority 
# number level 


Primary/ 

secondary? 

(P/S) 


2 

3 

4 
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ITEM 


(Options/Units) 


23) MDC-connected console (terminal) devices: 

SPD Channel Device 
name number type 


<= CONSOLE 


24) Diskette devices: 

SPD Channel 
name number 


25) Cartridge disk devices: 

Fixed 

SPD Channel platter? 
name number (YES/NO) 


26) Cartridge module disk devices: 

SPD Channel 
name number 
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ITEM 


(Options/Units) 


27) Storage module devices: 

SPD Channel 
name number 


28) Card reader devices: 

SPD Channel 
name number 


29) Card reader/punch or punch devices: 

SPD Channel 
name number 


30) Line printer devices: 

SPD Channel 
name number 


A 

V 


M-6 


CB23-03 




ITEM 


(Options/Units) 


31) Magnetic tape drives: 

SPD Channel 
name number 


32) Batch memory pool? _ (YES/NO) 


Size of batch pool _ nnnnn or nnk 

words 

33) Number of 512-word system 

overlay areas (1-99) _ (1 to 10) 
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APPENDIX N 


ERROR LOGGING 


Error logging is an optional feature that allows the system 
operator to collect memory or hardware-related error statistics 
for selected noncommunications peripheral devices. Error logging 
is intended primarily as a preventive maintenance tool, allowing 
for early detection and correction of potential memory or hard¬ 
ware failures. The error statistics collected can be used by 
Honeywell field engineering personnel to monitor memory and 
peripheral device performance to determine if corrective actions 
are required. 

As the system builder, you have the option of configuring 
error logging or not 1 . Once configured, the system operator must 
activate error logging through commands or macro calls. Error 
logging commands and operating procedures are described in the 
Commands manual and the Operator's Guide ; error logging macro 
calls are described in the System Service Macro Calls manual. 

CONFIGURATION REQUIREMENTS 


Error logging must be incorporated into your configuration 
before memory or device error logging can be activated. The 
following hardware and software requirements are necessary to 
configure error logging for your installation. 

Hardware Requirements 


Error logging requires that you have one or more noncommuni¬ 
cations devices in your configuration that you wish to monitor. 
(If you wish to log memory errors exclusively, peripheral devices 
need not be attached to the central processor.) In addition, 
cumulative file processing (described elsewhere in this appendix) 
requires that your installation have a CIP (or a CIP simulator). 


1 The interactive building program, M4_SYSDEF, does not allow you 
to configure error logging. You must incorporate the appro¬ 
priate software module by hand. 
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Software Requirements 


To implement error logging, you must load the bound unit 
ZERRST, located in directory SID, using an LDBU directive. If 
your working directory is SID, include the following directive in 
your CLM file: 

LDBU ZERRST 

Section 5 of this manual describes the LDBU directive in more 
detai1. 

MEMORY REQUIREMENTS 

The error logging facility requires a minimum memory area 
equivalent to the sum of the following components: 

• 254i6 words (SAF) or 263^ words (LAF) in the system 
memory pool for the bound unit ZERRST (of which 17 16 
words, the initialization section, is overwritten after 
use) 

• 22i6 words (SAF) or 23i6 words (LAF) in the system memory 
pool for each device that is monitored 

• 39 16 words (SAF or LAF) in the system or user memory pool 
for data for each error logging command 

• Space for the bound unit to process a particular error 
logging command 

Error logging can be run in the system task group ($S) or in 
a user group (e.g., $H). Since the memory area necessary to run 
the error logging bound unit can be quite large, error logging 
should not be executed from the $S group. The operator should 
initially create a group large enough to accommodate the error 
logging session. (If the system operator wishes to create and 
maintain error logging disk files, additional file space is 
required as well.) 
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APPENDIX P 


CONFIGURING DISPLAY FORMATTING AND CONTROL SOFTWARE 


This appendix describes the requirements for configuring the 
Display Formatting and Control software. Unless you configure 
this software for your installation, forms processing will not be 
available to users. If your installation uses the Data Entry 
Facility-II (DEF-II), you must configure Display Formatting and 
Control software. Users should have available for reference the 
Display Formatting and Control manual. 

CONFIGURATION REQUIREMENTS 


The following hardware and software requirements are neces¬ 
sary to configure the Display Formatting and Control Software. 

Hardware Requirements 


To perform forms processing, your installation requires one 
or more of the following asynchronous terminals connected to an 
MDC or an MLCP/DLCP: VIP 7200, VIP 7205, VIP 7207, VIP 7801, or 
VIP 7802, and a full-duplex modem such as type 103. 

Software Requirements 

To configure forms processing, you must answer 'yes' when the 
M4_SYSDEF program asks you if you wish to configure the Display 
Formatting and Control software for your installation, or you 
must include the appropriate directives in your CLM file as 
described below. 

CONFIGURATION DIRECTIVES 

The CLM directives required to configure the Display 
Formatting and Control Software depend on whether you wish to 
configure your terminals as noncommunications (MDC-connected) 
terminals or communications (MLCP-connected) terminals. The 
directives mentioned below are fully described in Sections 5 
and 6. 
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Configuring Noncommunications Terminals for Forms Processing 

The CLM directives required to configure the Display 
Formatting and Control software with noncommunications (MDC- 
connected) asynchronous terminals are as follows: 

VDAM 

This directive must be specified if the Display 
Formatting and Control software is to be incorporated in 
the configuration. (See Section 6 for a full description 
of this directive.) 


DEVICE CONnn,1rn,leve 
[record size] , 


-L / ^ 

r- _ . 


channel 
j B H , / 1 7 2 0 0 1 Kiel 
\N f | ( 'D7200 'j (T J 


^device name] 


For each asynchronous terminal ca 
Formatting Software, you must spe 
with the first parameter as CONnn 
must be specified as either '7200 
VIP 7205 support) or 
ninth parameter must 
visual display mode) or T (for te 
terminal runs in the mode you spe 
running in forms mode (i.e., runn 
software). Forms mode overrides 
teleprinter mode. 


'D7200 ' (for 
be specified 


pable of running Display 
cify a DEVICE directive 
. The eighth parameter 
' (for VIP 7200 or 
VIP 7207 support.) The 
as either C (for CRT 
leprinter mode). The 
cify whenever it is not 
ing the forms processing 
visual display mode or 


Configuring Communications Terminals for Forms Processing 

The CLM directives required to configure the Display 
Formatting and Control software with communications (MLCP- 
connected) asynchronous terminals are as follows: 

VDAM 

This directive must be specified if the Display 
Formatting and Control software is to be incorporated in 
the configuration. (See Section 6 for a complete 
description of this directive). 

COMM n 

This directive is required for a system that includes 
communications. It must precede all other 
communications-related directives. See Section 6 for a 
description of n, the number of interrupt priority 
levels. 


P-2 


CB23-03 


ATD 1rn,leve1,X'channel 1 ,[modem],speed. 


7200 

7801 

D7200 


[del],[stop-bit][,parity] 


DEVICE ATDnn,1rn,level,X'channel 1 ,[dev ice name]. 


[record size] 



For each asynchronous terminal capable of running Forms 
Processing Software, you must specify an ATD directive 
and its "paired" DEVICE directive. 1 The sixth parameter 
of the ATD directive must be specified as either 7200 
(for VIP 7200 or VIP 7205 support), 7801 (for VIP 7801 or 
VIP 7802 support), or D7200 (for VIP 7207 support). 

VIP 7200 terminals require a full duplex modem (such as 
type 103) to run forms processing. Additionally, the 
data rate (speed) in bits per second for any asynchronous 
terminal that will run forms processing should be in the 
range of 2400 to 9600. 


CONFIGURATION OPTIONS 


In addition to the configuration requirements described 
above, you have two options to consider when configuring forms 
processing for your installation. You may choose to activate the 
listener capability for terminals in your configuration. You 
also have the option of configuring the operator terminal such 
that you can perform forms processing in a one-terminal 
configuration. 

Listener performs specific operations affecting the state of 
a terminal. Whether you wish to activate the listener or not 
depends entirely on your installation's processing requirements. 
Refer to Appendix L for a complete description of the listener 
capabi1ity. 

The terminal configured as a standard operator terminal in 
your configuration does not support forms processing. If, how¬ 
ever, the operator terminal has been configured as a dual-purpose 
terminal that runs alternately under operator control and user 
control, users can utilize the forms processing capability when 
the terminal is under user control (i.e., not functioning as an 
operator console). In this way it is possible to run forms pro¬ 
cessing in a one-terminal configuration. Refer to Section 5 for 
information on configuring a dual-purpose operator terminal. 


i A1ternatively, you may specify a V7200 directive and its 
"paired" DEVICE directive. However, Honeywell recommends using 
the Asynchronous Terminal Device (ATD) driver. 
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